Sqlalchemy 1.4：替换关系为外键值以解决线程安全插入问题

问题背景 #

使用Sqlalchemy 1.4，现有模型定义如下：

class Parent(Base):
    __tablename__ = "parents"
    id = Column(Integer, primary_key=True)
    ... # 大量其他属性与关系

class Child(Base):
    __tablename__ = "childs"
    id = Column(Integer, primary_key=True)
    parent_id  = Column(Integer, ForeignKey("parents.id"), nullable=False)
    parent = relationship(Parent)
    ... # 大量其他属性与关系

通过旧会话获取Parent对象（expire_on_commit=False）：

session.expire_on_commit=False
parent = session.query(Parent).filter(Parent.id == 1).first()

基于该对象创建新Child并插入的逻辑，单线程运行正常，但并行批量创建Child时会抛出会话冲突错误：

sqlalchemy.exc.InvalidRequestError: Object '<Parent at 0x7fdcf96bdc10>' is already attached to session '51' (this is '52')

尝试过的方案及问题 #

• 无法直接用parent_id初始化Child，因为业务逻辑依赖Parent的属性及关联关系
• 尝试手动设置外键后清空关系：

  # 在新会话中插入Child时执行：
  child.parent_id = child.parent.id
  child.parent = None
  

  此时Child实例属性显示正常，但提交时parent_id被自动置空，触发数据库非空约束错误：

  {'S': 'ERROR', 'V': 'ERROR', 'C': '23502', 'M': 'null value in column "parent_id" of relation "childs" violates not-null constraint...'}
  

• 使用session.merge方法时，因实际场景中存在大量关联关系与属性，出现重复创建对象的问题

需求 #

• 最小代码改动：寻求简单方法，清空parent关系时保留parent_id，确保提交正常
• 支持复杂关系：可同时处理关联Child的GrandChild实例插入场景

解决方案 #

方法1：解除Parent对象的旧会话绑定（最小改动推荐） #

直接将Parent对象从旧会话中移除，使其成为游离状态，即可在新会话中安全关联，无需修改模型或业务逻辑：

# 在新会话中使用Parent前，先从旧会话解除绑定
old_session.expunge(parent)

# 后续正常创建Child并提交
new_child = Child(parent=parent)
new_session.add(new_child)
new_session.commit()

优势：完全保留Parent的所有属性与关联关系，满足业务逻辑依赖，代码改动极少，同时支持复杂嵌套关联（如GrandChild）的插入场景。

方法2：将Parent转为临时对象 #

使用make_transient方法剥离Parent与所有会话的关联，使其成为无状态的临时对象，同样可在新会话中使用：

from sqlalchemy.orm import make_transient

# 在新会话中使用前执行
make_transient(parent)

new_child = Child(parent=parent)
new_session.add(new_child)
new_session.commit()

适用场景：无法直接访问旧会话的场景（如Parent对象在跨进程/线程传递后），同样保留Parent的所有属性，支持复杂关系。

方法3：手动处理外键同步（针对必须手动设置id的场景） #

如果需要保留旧会话中的Parent对象，可通过关闭自动刷新+手动分离关系的方式避免外键被覆盖：

from sqlalchemy.orm import detach

with new_session.no_autoflush:
    new_child = Child(parent=parent)
    # 提取parent_id
    new_child.parent_id = new_child.parent.id
    # 手动分离Parent对象，避免触发关系同步逻辑
    detach(new_child.parent)
    # 清空关系
    new_child.parent = None

new_session.add(new_child)
new_session.commit()

注意：此方法仅适合简单关联场景，复杂嵌套关系下维护成本较高，优先推荐前两种方法。

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