SQLAlchemy双外键指向同表不同记录报AmbiguousForeignKeysError

你的关联设计本身完全合理，属于SQLAlchemy中同一张子表通过多个外键关联同一张父表的标准场景，报错的核心原因是你仅在Report子表侧的关系定义中添加了foreign_keys参数，父表User侧的两个反向关系没有同步指定外键映射规则，SQLAlchemy解析User.reports_received和User.reports_made两个关系时，依然无法区分两个外键路径的对应关系，因此抛出歧义错误。

在User类的两个relationship定义中，同步添加foreign_keys参数，明确每个关系对应的子表外键列即可。修正后的完整模型定义如下：

class User(Base):
    __tablename__ = "users"

    id: str = Column("id", String(16), primary_key=True)

    # 明确指定该关系关联Report表的reported_user_id外键
    reports_received = relationship(
        "Report",
        back_populates="reported_user",
        foreign_keys="[Report.reported_user_id]"
    )
    # 明确指定该关系关联Report表的reporting_user_id外键
    reports_made = relationship(
        "Report",
        back_populates="reporting_user",
        foreign_keys="[Report.reporting_user_id]"
    )

class Report(Base):
    __tablename__ = "reports"

    report_id: int = Column("report_id", Integer(), primary_key=True)

    reported_user_id = Column("reported_user_id", ForeignKey("users.id"))
    reporting_user_id = Column("reporting_user_id", ForeignKey("users.id"))

    reported_user = relationship(
        "User",
        back_populates="reports_received",
        foreign_keys=[reported_user_id]
    )
    reporting_user = relationship(
        "User",
        back_populates="reports_made",
        foreign_keys=[reporting_user_id]
    )

• 处理这类多外键双向关联时，关系两侧的relationship都必须明确指定foreign_keys，不能仅在单侧配置。父表侧使用字符串格式引用子表列，可以避免模型定义顺序先后导致的类找不到问题。
• 配置完成后所有关联查询、级联操作都可以正常运行，比如查询用户发起的举报、用户收到的举报，或者预加载关联数据时，SQLAlchemy会自动使用指定的外键作为连接条件，不需要额外手写关联规则。

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