SQLAlchemy 设置 expire_on_commit=False 仍报 DetachedInstanceError

服务函数用 sessionmaker.begin() 创建用户并返回 ORM 对象，函数外序列化它时却报 DetachedInstanceError 或 is not bound to a Session。即使已经设置 expire_on_commit=False，也要检查对象返回后是否仍关联会话，以及序列化需要的属性是否已经加载。

expire_on_commit=False 只控制提交后的过期行为，不让已关闭的 Session 继续保持对象关联，也不会提前加载所有关系。此文针对同步 SQLAlchemy 1.4/2.x 的会话范围和对象返回；异步上下文中的 MissingGreenlet 还需要单独处理 await 与隐式 I/O。

工厂的 begin 会在退出时关闭它创建的会话

下面是已有 User 映射和 engine 的结构示例。User.name 需对应实际模型字段，数据已经过业务校验：

from sqlalchemy.orm import sessionmaker

SessionFactory = sessionmaker(engine, expire_on_commit=False)

def create_user(name):
    with SessionFactory.begin() as db:
        user = User(name=name)
        db.add(user)
        return user

return 仍会执行上下文退出处理。正常退出时提交事务并关闭新建 Session，返回的 user 随后已是 detached 对象。关闭会话会移除它对 ORM 对象的关联，并释放连接资源。

已经加载且没有过期的普通属性，脱离会话后仍可能读取。因此不能只因对象 detached 就认定所有字段必然报错。错误通常出现在读取尚未加载的惰性关系、延迟列或已过期属性时：需要再访问数据库，但对象没有可用的关联 Session。

区分 SessionFactory.begin() 与已有实例 db.begin()。后者管理该 Session 的事务范围，不等于创建并关闭一个新 Session；不能只看到 begin 这个名称就认为两段代码生命周期相同。

需要继续使用 ORM 对象时，由调用方管理会话

如果后续业务仍要查询对象关系，应让同一业务单元持有 Session，再把它传给内部函数。下面仍是局部示例，不替代项目的完整异常、权限与事务设计：

def create_user(db, name):
    user = User(name=name)
    db.add(user)
    return user

with SessionFactory.begin() as db:
    user = create_user(db, validated_name)
    db.flush()
    result = {"id": user.id, "name": user.name}

内部函数只登记对象，由外层决定提交、回滚和关闭。flush 把待写内容发送到数据库，便于取得生成的主键；它会触发约束检查，并不等于已经提交。上下文成功退出后才能把此次写入作为成功响应处理，提交仍可能失败。

这项调整改变事务归属。原来每个函数独立提交的行为可能变成一起提交或回滚，需核对调用方和失败路径。不要让无关请求共用一个全局 Session，也不要仅为避免异常无限延长事务或不释放连接。

跨边界传数据时，返回普通结果更清楚

API 响应、任务队列或缓存只需要几项字段时，可以在有效 Session 范围内构造普通字典或数据对象，再交给后续代码。需要关系数据时，在这个范围中按查询需要加载并整理它，不把 ORM 对象当成可以随时跨进程取数据库数据的记录。

若必须返回脱离会话的 ORM 对象，明确预先加载消费方所需的列和关系，并按设计使用 expire_on_commit=False。selectinload 等选项只负责选定的关系，不代表所有字段都已加载。消费方需要新字段时，应一起更新这份数据契约。

保留已加载数据也意味着它不会仅因读取属性就自动刷新为数据库最新值。对新鲜度敏感的后续业务，应通过合适的会话和查询重新取得数据，而不是把 expire_on_commit=False 当成永久有效快照。

此外，rollback 对会话中保留的对象会产生过期效果，不受 expire_on_commit=False 控制。发生回滚后，不能继续用这些对象拼一个“创建成功”的结果；应沿正常失败处理结束该业务单元。

验收时覆盖序列化真正访问的字段

保存原函数、Session 管理与返回结构，在隔离数据中检查正常写入、约束失败、关系为空和关系有值。确认结果构造发生在可用会话范围内，外部序列化不再意外访问惰性数据库属性，提交失败也不会返回成功。

仅测试 user.name 能读并不足够，响应模型可能还访问其他延迟字段。调整返回结构时核对接口兼容性；回退代码和事务管理不会撤销已经提交的写入，必要的数据纠正应按业务记录处理。