Async SQLAlchemy懒加载时访问预加载关联关系的问题

问题原因 #

• 会话生命周期限制：你在async with db_session上下文里用awaitable_attrs加载了Child对象，但退出上下文后，会话被关闭，这些Child对象就和数据库会话断开了（进入Detached状态）。
• 懒加载依赖活跃会话：Child的toys关联配置了lazy="selectin"，这种懒加载策略需要对象绑定在活跃的数据库会话上才能触发查询。会话关闭后，对象没有会话支持，自然无法执行懒加载操作，所以抛出DetachedInstanceError。
• awaitable_attrs的局限性：它只负责加载指定的关联属性，不会自动将加载出的子对象后续的关联操作绑定到原会话，一旦会话结束，子对象的后续懒加载就失效了。

解决方法 #

1. 在会话内完成所有关联属性访问 #

把访问toys的代码放到会话上下文内部，确保触发懒加载时对象还绑定在活跃会话上：

async with db_session:
    children = await parent.awaitable_attrs.children
    # 此时会话还活跃，能正常触发toys的懒加载
    print(children[0].toys)

2. 预加载Child的toys关联 #

修改关联配置或查询语句，在加载Parent的children时就一次性预加载对应的toys，避免后续懒加载：

方式A：修改Parent的关联配置

from sqlalchemy.orm import selectinload

class Parent(Base):
    __tablename__ = "parent"

    children: Mapped["Child"] = relationship(
        "Child",
        back_populates="parent",
        # 配置默认预加载children的toys
        lazy="selectin",
        cascade="all, delete-orphan",
        options=[selectinload("children.toys")]
    )

方式B：查询时显式指定预加载（更灵活）

from sqlalchemy.orm import selectinload

async with db_session:
    # 查询Parent时，同时预加载children和对应的toys
    parent = await db_session.get(
        Parent, 
        parent_id, 
        options=[selectinload(Parent.children).selectinload(Child.toys)]
    )
    children = parent.children
# 会话关闭后，toys已经被预加载完成，可直接访问
print(children[0].toys)

3. 重新绑定对象到新会话（不推荐） #

如果必须在会话外访问，可以将Child对象重新加入新的会话，但这种方式可能导致数据不一致，仅在特殊场景下使用：

async with db_session:
    children = await parent.awaitable_attrs.children
    child_id = children[0].id

async with db_session_new:
    # 从新会话中重新获取对象
    child = await db_session_new.get(Child, child_id)
    print(child.toys)

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