SQLAlchemy：如何将第二个表联接到分层表并让联接覆盖所有查询层级？

你遇到的核心问题是：join(NodeType)仅会在SQL层面关联父节点与NodeType表，但ORM并不会自动将这种关联加载延伸到子节点和孙节点的node_type属性。要实现全层级加载，需要使用SQLAlchemy的关联加载选项（而非普通的join）来指定嵌套层级的关联加载策略。

方案一：查询时显式指定全层级关联加载 #

使用sqlalchemy.orm.joinedload，逐层定义每个Node层级都加载对应的node_type，包括父节点、子节点、孙节点：

from sqlalchemy.orm import joinedload

# 加载父节点的node_type，以及两层children各自的node_type
nodes = session.query(Node).options(
    joinedload(Node.node_type),
    joinedload(Node.children).joinedload(Node.node_type),
    joinedload(Node.children).joinedload(Node.children).joinedload(Node.node_type)
).all()

这样执行查询后，所有层级的Node对象的node_type都会被预先加载，不会触发额外的SQL查询。

方案二：修改模型关系，默认加载关联对象 #

如果希望每次加载children时都自动加载对应的node_type，可以在定义children关系时添加加载选项：

from sqlalchemy.orm import joinedload

class Node(Base):
    __tablename__ = "node"
    id = Column(Integer, primary_key=True)
    parent_id = Column(Integer, ForeignKey("node.id"))
    data = Column(String(50))
    children = relationship(
        "Node",
        lazy="joined",
        join_depth=2,
        options=[joinedload("node_type")]
    )
    node_type = relationship("NodeType", back_populates="node")

之后只需查询父节点的node_type，所有层级的children的node_type会自动加载：

nodes = session.query(Node).options(joinedload(Node.node_type)).all()

关键说明 #

• 普通的join()方法用于构造SQL的JOIN子句（多用于过滤或查询字段），不会自动加载ORM关联对象；
• 要加载ORM关联对象（包括嵌套层级的关联），必须使用joinedload/selectinload这类加载选项，它们会告诉SQLAlchemy如何预加载关联的对象。

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