SQLAlchemy多对多模型插入关联数据报主键重复错误如何解决

• 直接触发报错的原因是你数据库中实际存在的user_app_sections表结构和模型定义不匹配：当前表的主键仅为application_id单字段，而非代码中定义的application_id + section_id联合主键，导致同一个应用ID只能插入一条关联记录，当你尝试把同一个应用关联到第二个分区时，就会触发1062主键重复错误。这个问题一般是早期建表时只给application_id设置了主键，后续修改模型后没有执行数据库同步/迁移导致的。
• 现有模型设计存在深层逻辑缺陷：你的业务规则明确要求「分区唯一归属于所属用户」，也就是说分区只能关联当前分区所属用户自己已绑定的应用，但现有user_app_sections关联表没有用户维度的字段，无法做归属校验，后续会出现跨用户数据越权的问题（比如A用户的分区可以关联B用户的私有应用）。

方案1：快速修复（仅解决主键报错，不解决数据越权隐患） #

1. 删除数据库中现有的user_app_sections表，或者执行迁移操作，将表的主键更新为(application_id, section_id)联合主键，保证表结构和模型定义一致。
2. 给所有关联关系补充back_populates配置，避免两边关系不同步导致重复插入，调整后的关系配置如下：

class User(UserMixin, db.Model):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(40), nullable=False)
    username = db.Column(db.String(20), nullable=False, unique=True)
    email = db.Column(db.String(320), nullable=False, unique=True)
    password = db.Column(db.String(90), nullable=False)
    applications = db.relationship('Application', secondary='user_app', back_populates='users')
    sections = db.relationship('Section', backref='user', back_populates='user')

class Application(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    users = db.relationship('User', secondary='user_app', back_populates='applications')
    sections = db.relationship('Section', secondary='user_app_sections', back_populates='applications')

class Section(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(255), nullable=False)
    user_id = db.Column(db.Integer, db.ForeignKey('user.id'))
    user = db.relationship('User', back_populates='sections')
    applications = db.relationship('Application', secondary='user_app_sections', back_populates='sections')

操作时注意不要给同一个分区重复添加相同应用，否则依然会触发联合主键冲突。

方案2：适配业务规则的最优修复（解决主键问题+数据越权隐患） #

调整user_app_sections关联表结构，加入用户维度字段，从数据库层面保证关联关系的归属合法性，修改后的完整模型代码如下：

class User(UserMixin, db.Model):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(40), nullable=False)
    username = db.Column(db.String(20), nullable=False, unique=True)
    email = db.Column(db.String(320), nullable=False, unique=True)
    password = db.Column(db.String(90), nullable=False)
    # 用户-应用关联
    applications = db.relationship(
        'Application', 
        secondary='user_app', 
        back_populates='users',
        lazy='dynamic'
    )
    # 用户-分区关联
    sections = db.relationship(
        'Section', 
        back_populates='user',
        cascade='all, delete-orphan'
    )

class Application(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(255), nullable=False) # 补充原模型缺失的应用名称字段
    users = db.relationship(
        'User', 
        secondary='user_app', 
        back_populates='applications'
    )
    # 应用-分区关联，通过关联表自动过滤归属用户
    sections = db.relationship(
        'Section', 
        secondary='user_app_sections', 
        back_populates='applications'
    )

class Section(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(255), nullable=False)
    user_id = db.Column(db.Integer, db.ForeignKey('user.id'), nullable=False)
    user = db.relationship('User', back_populates='sections')
    applications = db.relationship(
        'Application', 
        secondary='user_app_sections', 
        back_populates='sections'
    )

# 用户-应用多对多关联表（原有逻辑不变）
user_app = db.Table(
    'user_app',
    db.Column('user_id', db.Integer, db.ForeignKey('user.id'), primary_key=True),
    db.Column('application_id', db.Integer, db.ForeignKey('application.id'), primary_key=True),
    db.Column('last_used_time', db.DateTime, nullable=True)
)

# 调整后的应用-分区多对多关联表，加入用户维度做联合主键和外键校验
user_app_sections = db.Table(
    'user_app_sections',
    db.Column('user_id', db.Integer, primary_key=True),
    db.Column('application_id', db.Integer, primary_key=True),
    db.Column('section_id', db.Integer, db.ForeignKey('section.id'), primary_key=True),
    # 外键约束：保证关联的应用属于当前用户
    db.ForeignKeyConstraint(
        ['user_id', 'application_id'],
        ['user_app.user_id', 'user_app.application_id'],
        name='fk_user_app_section_user_app'
    ),
    # 可选：数据库层面校验分区属于当前关联的用户，需要数据库支持CHECK约束
    db.CheckConstraint(
        'user_id = (SELECT user_id FROM section WHERE section.id = section_id)',
        name='ck_section_owner_match'
    )
)

修改完成后删除原有错误的关联表，执行表同步即可。后续给分区关联应用时，只要保证应用已经提前绑定到分区所属用户，就可以正常将同一个应用关联到该用户下的多个分区，且不会出现跨用户数据混乱的问题。

注意：如果使用的是MySQL 5.x版本，不支持CHECK约束，可以去掉对应配置，在代码逻辑层面做分区归属校验即可。

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