如何解决多外键导致的AmbiguousForeignKeysError错误

出现这个异常的核心原因是：PatientDetails表存在两个指向Users表的外键，SQLAlchemy无法自动推断出Users.patient_details关联对应的是哪一个外键关系，因此需要显式指定关联规则。

修改方案 #

需要分别调整Users和PatientDetails中的关系定义，明确每个关联对应的外键：

1. 调整PatientDetails模型的关联关系
   给每个指向Users的关联指定对应的外键和反向关联名称，同时修正类名拼写（原代码中写的"User"应为"Users"）：

   class PatientDetails(Base):
       __tablename__ = "patient_details"
       __table_args__ = (
           Index("patient_basic_details_id", "patient_basic_details_id", unique=True),
       )
   
       id = Column(String(36), primary_key=True)
       sex = Column(String(10), nullable=False)
       dob = Column(Date, nullable=False)
       is_married = Column(Boolean, nullable=False)
       spouse_name = Column(String(20), nullable=True)
       emergency_contact_number = Column(String(13), nullable=True)
       allergies = Column(ForeignKey("allergies.id"), nullable=False)
       address = Column(String(200), nullable=False)
       long = Column(String(100), nullable=False)
       lat = Column(String(100), nullable=False)
   
       patient_basic_details_id = Column(ForeignKey("users.id"), nullable=False)
       # 明确关联作为患者的用户，指定外键和反向关联
       patient_basic_details = relationship("Users", back_populates="as_patient_details", foreign_keys=[patient_basic_details_id])
       
       provider_basic_details_id = Column(ForeignKey("users.id"), nullable=False)
       # 明确关联作为提供者的用户，指定外键和反向关联
       provider_basic_details = relationship("Users", back_populates="as_provider_patient_details", foreign_keys=[provider_basic_details_id])
   

2. 调整Users模型的关联关系
   将原来单一的patient_details拆分为两个关联，分别对应PatientDetails中的两个反向关系：

   class Users(Base):
       __tablename__ = "users"
       __table_args__ = (
           Index("email", "email", unique=True),
           Index("mobile_number", "mobile_number", unique=True),
       )
   
       id = Column(String(36), primary_key=True)
       first_name = Column(String(20), nullable=False)
       last_name = Column(String(20), nullable=False)
       email = Column(String(50), nullable=False)
       mobile_number = Column(String(13), nullable=False)
       password = Column(String(100), nullable=False)
       is_active = Column(Boolean, nullable=False, default=False)
       picture = Column(String(100), nullable=True)
   
       role_id = Column(ForeignKey("roles.id"), nullable=False)
       role = relationship("Roles", back_populates="user")
   
       provider_details = relationship("ProviderDetails")
       provider_practitioners = relationship("ProviderPractitioner")
       # 替换原patient_details为两个明确的关联
       as_patient_details = relationship("PatientDetails", back_populates="patient_basic_details", foreign_keys=[PatientDetails.patient_basic_details_id])
       as_provider_patient_details = relationship("PatientDetails", back_populates="provider_basic_details", foreign_keys=[PatientDetails.provider_basic_details_id])
       patient_diagnosis = relationship("PatientDiagnosis")
       invites = relationship("Invites", back_populates="invited_by_user")
   

关键说明 #

• 通过foreign_keys参数，显式告诉SQLAlchemy每个关联使用的外键字段，消除歧义。
• 使用back_populates让两端的关联互相绑定，确保ORM能正确维护对象之间的关联关系。
• 修正了原代码中relationship("User")的类名错误，模型类实际为Users，必须保持一致。

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