如何在SQLAlchemy ORM中正确配置自引用外键关系及back_populates参数？

首先先修正你代码里的几个关键问题，再解释自关联场景下的关系配置逻辑：

• 表名不匹配：__tablename__ = "user"与外键引用的node.node_id冲突，应改为__tablename__ = "node"
• 拼写错误：parrent_id、parrent_node应为parent_id、parent_node
• 缺少关系方向指定：自关联的一对多关系需要明确关联方向，否则SQLAlchemy无法区分父/子节点的关联逻辑

修正后的完整代码 #

from sqlalchemy import ForeignKey
from sqlalchemy.orm import Mapped, mapped_column, relationship, Optional, List
from sqlalchemy.ext.declarative import Base

class Node(Base):
    __tablename__ = "node"

    node_id: Mapped[int] = mapped_column(primary_key=True, autoincrement=True)
    parent_id: Mapped[Optional[int]] = mapped_column(ForeignKey("node.node_id"))  # 允许根节点无父节点

    # 父节点关联：一个子节点对应一个父节点
    parent_node: Mapped[Optional["Node"]] = relationship(
        back_populates="child_nodes",
        remote_side=[node_id]
    )
    # 子节点关联：一个父节点对应多个子节点
    child_nodes: Mapped[List["Node"]] = relationship(
        back_populates="parent_node",
        cascade="all, delete-orphan"  # 可选：删除父节点时自动删除子节点
    )

关键配置说明 #

1. back_populates的核心逻辑
   不管是不是自关联，back_populates的值始终是关系另一方的属性名称。这里parent_node的back_populates指向child_nodes，child_nodes的back_populates指向parent_node，和跨类关联的配置逻辑完全一致——本质就是让SQLAlchemy知道两个属性是同一关系的双向映射。

2. remote_side的作用
   自关联场景下，SQLAlchemy无法自动判断关系方向，remote_side=[node_id]明确指定：当前关系的远程关联字段是父节点的node_id，以此区分"父节点拥有子节点"和"子节点属于父节点"的双向关系。

3. 额外优化点

• 将parent_id设为Optional[int]，允许存在无父节点的根节点，符合树形结构的常见需求
• 添加cascade="all, delete-orphan"可实现父节点删除时自动级联删除子节点，按需选择即可

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