SQLAlchemy 如何通过中间关联表构建一对多关联关系

核心问题定位 #

你之前遇到重复写入关联字段的根本原因：把中间表ParentChild当成了普通关联对象绑定到了Parent/Child的relationship链上，形成了Parent -> ParentChild -> Child的两层关联，而非直接穿透中间表实现Parent和Child的业务层关联。
你的场景本质是通过无额外业务字段的中间表实现的逻辑一对多关系，且受现有数据库限制不能在Child表上加直接外键，关联规则完全匹配：

• 单Parent可关联多Child
• 单Child仅能关联一个Parent（对应中间表child_id字段有唯一约束）

具体配置实现 #

首先对齐现有数据库的约束，结合SQLAlchemy的表定义要求补全主键规则：因为业务上一个child仅能对应一个parent，所以中间表的child_id作为主键天然满足唯一性要求，不需要修改原有数据库结构。完整模型定义如下：

from sqlalchemy import Column, Integer, ForeignKey, UniqueConstraint
from sqlalchemy.orm import relationship

class Parent(Base):
    __tablename__ = 'parent'
    id = Column(Integer, primary_key=True)
    children = relationship(
        "Child",
        secondary="parent_children",  # 直接指定中间表作为关联桥，不绑定到类实例
        primaryjoin="Parent.id == parent_children.c.parent_id",
        secondaryjoin="Child.id == parent_children.c.child_id",
        back_populates="parent",  # 双向同步Child侧的关联状态
        cascade="all, delete"  # Parent删除时自动清理中间表的关联记录
    )

class ParentChild(Base):
    __tablename__ = 'parent_children'
    child_id = Column(Integer, ForeignKey('child.id'), primary_key=True)
    parent_id = Column(Integer, ForeignKey('parent.id'), nullable=False)
    # 表层面加唯一约束兜底，和现有数据库规则对齐
    __table_args__ = (UniqueConstraint('child_id', name='uq_child_id'),)

class Child(Base):
    __tablename__ = 'child'
    id = Column(Integer, primary_key=True)
    parent = relationship(
        "Parent",
        secondary="parent_children",
        primaryjoin="Child.id == parent_children.c.child_id",
        secondaryjoin="Parent.id == parent_children.c.parent_id",
        back_populates="children",
        uselist=False  # 关键：标记为单值关联，符合一个child仅对应一个parent的规则
    )

配置说明 #

• 关联逻辑完全匹配你原生SQL的三表联查路径，ORM会自动生成对应JOIN语句，无需手动编写查询
• 因为没有将ParentChild作为独立类绑定到两侧的relationship链上，ORM不会额外创建ParentChild实例，只会在中间表写入必要的parent_id、child_id关联值，从根源避免重复写入问题
• 双向back_populates配置保证关联操作自动同步：
  • 执行parent.children.append(child)时，ORM自动在中间表插入对应关联记录
  • 执行child.parent = new_parent时，ORM自动更新中间表的关联记录，不会残留旧的脏数据

常见避坑点 #

• 不要在上述配置基础上，额外给Parent和ParentChild、Child和ParentChild单独定义relationship，否则会形成两层关联绑定，再次触发重复写入问题
• uselist=False是Child侧关联的核心参数，必须显式声明，否则ORM会默认将该关联解析为列表类型，不符合单Child对应单Parent的业务规则

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