Flask-SQLAlchemy继承列冲突：db.Column无use_existing_column参数如何处理？

当你在Flask-SQLAlchemy中使用类继承，且多个子类存在同名列导致冲突时，不用修改列名，直接用mapped_column替代db.Column即可解决——因为Flask-SQLAlchemy的SQLAlchemy实例等价于SQLAlchemy的ORM模块，mapped_column支持原生的use_existing_column参数。

具体实现步骤 #

1. 定义抽象基类（用于共享通用字段，可选但推荐）：

from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()

class BaseModel(db.Model):
    __abstract__ = True
    id = db.Column(db.Integer, primary_key=True)

2. 在子类中使用mapped_column并传入use_existing_column=True：

class SubModelA(BaseModel):
    __tablename__ = 'sub_a'
    # 用mapped_column替代Column，启用use_existing_column避免冲突
    name = db.mapped_column(db.String(50), use_existing_column=True)

class SubModelB(BaseModel):
    __tablename__ = 'sub_b'
    name = db.mapped_column(db.String(50), use_existing_column=True)

原理说明 #

mapped_column是SQLAlchemy 2.0+引入的ORM原生列构造器，Flask-SQLAlchemy 3.0+版本已将其集成到db实例中。设置use_existing_column=True后，SQLAlchemy会检测并复用继承链中已存在的同名列定义，不会重复创建或触发冲突错误。

如果你的Flask-SQLAlchemy版本较低，建议升级到3.0+版本以支持该特性。

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