SQLAlchemy插入关联已存在父对象的子对象并获取子主键问题

问题原因说明 #

你遇到的两个问题本质是对SQLAlchemy的对象状态管理不熟悉：

• 使用Session.add报错是因为你手动构造的Parent(id=1)属于临时状态，SQLAlchemy会默认将其判定为待插入新对象，触发主键唯一约束冲突
• 使用Session.merge拿不到子对象id，是因为merge不会修改你传入的游离对象，只会返回一个和当前会话绑定的托管对象，你直接读取原始游离对象的id自然返回None

正确实现方案 #

方案1：直接赋值外键（最高效，无额外查询） #

你已经明确知道父对象id，完全不需要构造父对象实例，直接给子对象的外键字段赋值即可，彻底规避父对象的状态处理问题：

# 父表中已存在id=1的Parent记录
child = Child(parent_id = 1)
with Session(engine) as session:
    session.add(child)
    session.commit()
    # 可正常读取生成的主键
    print("child.id = " + str(child.id))

方案2：正确使用Session.merge（需要保留父对象关联写法时使用） #

接收merge返回的托管对象，从托管对象中读取同步后的主键值：

# 父表中已存在id=1的Parent记录
parent = Parent(id = 1)
child = Child(parent = parent)
with Session(engine) as session:
    # 接收merge返回的、与会话绑定的托管对象
    managed_child = session.merge(child)
    session.commit()
    # 从托管对象读取主键
    print("child.id = " + str(managed_child.id))

方案3：手动标记父对象为已存在（无额外查询，适合必须关联父实例场景） #

如果既不想直接赋值外键，也不想用merge，可以手动将构造的父对象标记为已持久化，告诉SQLAlchemy不要重复插入：

from sqlalchemy.orm import make_transient_to_detached

parent = Parent(id=1)
# 标记父对象为已存在的游离对象，SQLAlchemy不会尝试插入
make_transient_to_detached(parent)

child = Child(parent=parent)
with Session(engine) as session:
    session.add(child)
    session.commit()
    print("child.id = " + str(child.id))

内容的提问来源于stack exchange，提问作者Guillaume Chérel