SQLAlchemy同表自引用设置back_populates关联parent_id报错

两个配置错误直接导致异常：

• 双向关联配置自指：parent关系的back_populates参数填了"parent"，等于让关系和自己做双向绑定，根本没有定义反向关联属性，ORM无法识别关联两侧的对应关系。
• 自引用关联缺少remote_side声明：同表邻接表结构的关联中，SQLAlchemy无法自动区分哪个字段是关联的本地端、哪个是远端，必须显式指定才能判断是多对一还是一对多方向，你遇到的报错提示也明确指出了这一点。

完整的双向关联配置如下，区分父级（多对一）和子级（一对多）两个方向的关系：

class People(Base):
    __tablename__ = "people"

    id = Column(Integer, primary_key=True)
    name = Column(String(20), nullable=False, unique=True)
    parent_id = Column(Integer, ForeignKey('people.id'))
    # 父级关联：指向当前人员的上一级，remote_side声明id是关联目标端的字段
    parent = relationship("People", back_populates="children", remote_side=[id], uselist=False)
    # 子级关联：指向当前人员下的所有直属下级，反向绑定parent
    children = relationship("People", back_populates="parent")

• 如果你不需要通过父节点直接查询所有子节点，只需要保留向上查父级的能力，可以简化为单向关联，去掉back_populates即可，不需要定义children属性：

  parent = relationship("People", remote_side=[id], uselist=False)
  

• 配置生效后，你示例中创建无父级根节点的代码session.add(People(name='me'))可以正常运行，不会再抛出参数异常。
• 双向关联支持自动同步关联关系：比如给节点A的children列表追加节点B，ORM会自动给B的parent_id赋值为A的id，无需手动维护外键字段。

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