SQLAlchemy InvalidRequestError求助：同键实例会话冲突且expunge解绑无效

我之前也踩过这个SQLAlchemy的坑！这个报错本质是SQLAlchemy的会话（Session）会严格维护每个主键对应的唯一实例——当你尝试把一个和现有实例主键相同的对象附加到会话时，就会触发这个错误。你说用expunge方法失效，大概率是操作时机或者方式不对，下面给你几个实用的解决方案：

1. 优先复用会话中已存在的实例 #

在添加新对象之前，先检查会话里有没有对应主键的实例，直接用它就行，完全没必要硬加新对象：

# 先查询会话中是否已有该category实例
existing_category = session.query(Category).get(category.id)
if existing_category:
    # 直接复用这个实例，比如关联到product上
    product.category = existing_category
else:
    # 确实没有才添加新实例
    session.add(category)

2. 正确使用expunge的姿势 #

如果确实需要替换实例，一定要在添加新对象之前expunge旧实例，还要确认expunge真的生效了：

existing_category = session.query(Category).get(category.id)
if existing_category:
    # 先移除旧实例
    session.expunge(existing_category)
    # 用session.contains()确认旧实例已经不在会话中了
    assert not session.contains(existing_category)
    # 现在可以安全添加新的category实例
    session.add(category)

要是你在session.add(category)之后才去expunge旧实例，这时候会话已经在跟踪新对象了，再操作旧实例就没意义了，这也是很多人觉得expunge失效的原因。

3. 用merge方法一键解决重复问题 #

SQLAlchemy提供了session.merge()方法，它会自动帮你处理会话中的重复实例：如果会话里已有对应主键的实例，merge会返回那个实例；如果没有，就把新实例附加到会话中。用这个方法能省掉很多手动判断的麻烦：

# merge会自动处理重复键的情况，返回会话中有效的实例
merged_category = session.merge(category)
# 直接用返回的实例做后续操作
product.category = merged_category

为什么你的expunge会失效？ #

大概率是这两个原因：

• 操作时机错了：在添加新对象之后才去expunge旧实例，此时会话已经锁定了新实例的主键，旧实例的expunge不会影响新实例的添加冲突。
• 对象引用不对：你expunge的对象可能不是会话中实际跟踪的那个（比如你创建了一个新的category对象，主键和旧实例一样，但expunge的是另一个引用）。

内容的提问来源于stack exchange，提问作者Pascal de Sélys