如何在Flask SQLAlchemy中实现PostgreSQL表继承？

PostgreSQL的表继承是数据库层面的原生特性，和SQLAlchemy默认的ORM继承逻辑（单表/关联表继承）完全不同。你之前的错误在于用外键约束模拟继承，这和PostgreSQL的原生逻辑冲突——原生继承下插入子表时，数据库会自动将父表字段的数据同步写入父表，不需要手动维护外键关系。

通过修改模型定义并监听表创建事件，让SQLAlchemy生成符合PostgreSQL继承规则的表结构：

from flask_sqlalchemy import SQLAlchemy
from sqlalchemy import event
from sqlalchemy.schema import CreateTable

db = SQLAlchemy()

class Users(db.Model):
    __tablename__ = 'users'
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(50), unique=True, nullable=False)
    password = db.Column(db.String(255), nullable=False)

class Admins(Users):
    __tablename__ = 'admins'
    # 不重复定义id，直接继承父表的字段
    access_level = db.Column(db.Integer, nullable=False)
    # 指定PostgreSQL表继承关系
    __table_args__ = {'postgresql_inherits': 'users'}

# 监听子表创建事件，移除SQLAlchemy自动添加的主键约束
@event.listens_for(Admins.__table__, "before_create")
def before_create_admins_table(target, connection, **kwargs):
    create_stmt = str(CreateTable(target))
    # 移除子表的主键定义（父表已存在主键，子表无需重复）
    create_stmt = create_stmt.replace("PRIMARY KEY (id),", "")
    connection.execute(create_stmt)
    return True

插入数据 #

直接创建Admins实例提交即可，PostgreSQL会自动同步数据到父表：

admin = Admins(username='superadmin', password='your_hashed_password', access_level=10)
db.session.add(admin)
db.session.commit()

执行后，id、username、password会写入users表，access_level写入admins表。

如果ORM层面的配置仍有问题，可以跳过SQLAlchemy的自动表创建，用原生SQL定义继承关系：

1. 先创建父表users

class Users(db.Model):
    __tablename__ = 'users'
    id = db.Column(db.Integer, primary_key=True)
    username = db.Column(db.String(50), unique=True, nullable=False)
    password = db.Column(db.String(255), nullable=False)

# 创建父表
db.create_all()

2. 手动执行SQL创建子表admins

# 执行PostgreSQL原生创建继承表的语句
db.session.execute("""
CREATE TABLE admins (
    access_level INTEGER NOT NULL
) INHERITS (users);
""")
db.session.commit()

3. 定义Admins模型对应已创建的表

class Admins(Users):
    __tablename__ = 'admins'
    access_level = db.Column(db.Integer, nullable=False)
    # 无需定义id，直接继承Users模型的字段

4. 插入数据的方式和方案一完全一致。

• 不要在子表模型中定义id为外键或主键，PostgreSQL原生继承会自动复用父表主键，手动添加约束会导致插入冲突。
• SQLAlchemy默认会给子表添加主键约束，必须通过事件监听或手动SQL移除该约束，否则数据库会报错。
• 插入子表时，直接创建子表模型实例提交即可，PostgreSQL会自动处理父表的数据写入，无需手动操作父表。

内容的提问来源于stack exchange，提问作者Alexei Andronov