SQLAlchemy多表关联报错：映射类不适用查询根实体求助

1. 修正模型中的拼写错误 #

在Parent类中，外键字段名存在拼写错误：gramdparent_id需修正为**grandparent_id**，该错误会导致外键关联失效，直接影响关系映射的正常工作：

class Parent(Base):
    __tablename__ = "parents"

    # 修正拼写错误
    grandparent_id: Mapped[str] = mapped_column(
        ForeignKey(
            "grandparents.id",
            ondelete="CASCADE",
        ),
    )
    grandparent: Mapped["Grandparent"] = relationship(lazy="joined", innerjoin=True)

2. 调整contains_eager的路径写法 #

报错核心原因是嵌套的contains_eager未明确从根实体（Child）出发的完整关联链。若查询以Child为起点，调整后的正确代码如下：

# 构建查询并关联表
stmt = select(Child).join(Child.parent).join(Parent.grandparent)
# 正确设置contains_eager选项
stmt = stmt.options(
    contains_eager(Child.parent).contains_eager(Parent.grandparent)
)

若仍存在路径歧义，可通过select_from明确指定查询起点：

stmt = select(Child).select_from(Child).join(Child.parent).join(Parent.grandparent)
stmt = stmt.options(
    contains_eager(Child.parent).contains_eager(Parent.grandparent)
)

额外可选方案 #

若无需手动控制JOIN逻辑，可直接使用joinedload自动处理关联加载，代码更简洁：

stmt = select(Child).options(
    joinedload(Child.parent).joinedload(Parent.grandparent)
)

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