SQLAlchemy问题：添加实例到会话时其他实例被自动添加的原因与解决

现象原因 #

SQLAlchemy的ORM会话执行session.add()时，默认会对关联对象执行级联保存操作，这是由relationship的cascade参数默认值（'save-update, merge'）控制的。

具体到你的场景：

• 你创建了临时状态的CrustaceanGroup（未加入会话），并让Shrimp和Lobster都关联它；
• 调用session.add(Shrimp)时，SQLAlchemy会遍历Shrimp的关联对象CrustaceanGroup；
• 接着遍历CrustaceanGroup的families集合（包含Shrimp和Lobster）；
• 所有处于transient（临时、未被会话管理）状态的关联对象都会被自动加入会话，因此Lobster也被添加进去。

当两个Family未关联同一个Group时，Shrimp没有关联其他未被管理的Family，所以只有它自己被加入会话，符合预期。

避免自动添加的方法 #

1. 调整relationship的级联规则 #

在定义模型的relationship时，修改cascade参数，移除默认的save-update：

# 修改Group类的families关系，仅保留merge级联
families = relationship('Family', back_populates='group', cascade='merge')
# 或者完全关闭自动级联保存
families = relationship('Family', back_populates='group', cascade='')

这样添加Shrimp时，只会处理目标对象本身，不会级联添加关联的Group和其他Family。

2. 使用add_without_transient()替代add() #

SQLAlchemy提供的add_without_transient()方法仅添加目标对象，不会级联处理关联的临时对象：

session.add_without_transient(Shrimp)
session.query(Family).all()  # 仅返回Shrimp实例

该方法适合临时关闭级联添加的场景，无需修改模型定义。

3. 先将Group加入会话再关联Family #

若需保留级联行为但不想自动添加Lobster，可先把Group加入会话，再创建关联的Family：

CrustaceanGroup = Group(id='crustaceans', name='Crustaceans')
session.add(CrustaceanGroup)  # 先将Group纳入会话管理

Shrimp = Family(id='shrimp', name='Shrimp', group=CrustaceanGroup)
Lobster = Family(id='lobster', name='Lobster', group=CrustaceanGroup)

session.add(Shrimp)
session.query(Family).all()  # 仅返回Shrimp实例

此时Group已被会话管理，添加Shrimp时不会再级联处理其关联的临时对象，Lobster不会被自动加入。

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