SQLAlchemy双向关联出现NoForeignKeysError错误求助

我之前在使用SQLAlchemy的relationship时也碰到过一模一样的问题，咱们一步步来排查和解决：

1. 先排查最常见的原因：Schema前缀问题 #

你在Child类的ForeignKey里写了'public.parent.id'，这个前缀public.很可能是问题所在：

• 如果你的Parent表没有显式指定schema为public，SQLAlchemy会默认使用数据库的默认schema（比如很多情况下是public，但如果你的Base类或者表配置了其他schema就会出错）。
• 最简单的测试方法是先去掉public.前缀，修改Child类的外键列：

parent_id = Column(Integer, ForeignKey('parent.id'))

如果你的项目确实需要使用public schema，那建议统一配置：
要么给Parent类加上schema参数：

class Parent(Base):
    __tablename__ = 'parent'
    __table_args__ = {'schema': 'public'}  # 指定表的schema
    id = Column(Integer, primary_key=True)
    children = relationship("Child", back_populates="parent")

要么给整个Base类设置默认schema：

Base = declarative_base()
Base.metadata.schema = 'public'  # 所有继承Base的表默认使用public schema

2. 显式指定primaryjoin参数（排查用） #

如果去掉schema前缀还是报错，可以尝试显式指定关联条件，强制告诉SQLAlchemy如何关联两张表：

class Parent(Base):
    __tablename__ = 'parent'
    id = Column(Integer, primary_key=True)
    # 显式指定关联条件
    children = relationship("Child", back_populates="parent", primaryjoin="Parent.id == Child.parent_id")

class Child(Base):
    __tablename__ = 'child'
    id = Column(Integer, primary_key=True)
    parent_id = Column(Integer, ForeignKey('parent.id'))
    parent = relationship("Parent", back_populates="children", primaryjoin="Child.parent_id == Parent.id")

如果这样能解决问题，说明之前的外键解析确实存在schema或者表名匹配的问题。

3. 检查表的创建与数据库状态 #

• 确认你执行了Base.metadata.create_all(engine)来创建所有表，并且没有报错。如果是之前创建的表没有外键约束，可能需要删除旧表重新创建，或者手动添加外键约束。
• 检查数据库中child表的parent_id列是否真的存在外键关联到parent表的id列。

4. 确认映射类的基础配置 #

• 确保Parent和Child都正确继承了同一个Base类，并且Base已经和你的数据库引擎正确绑定（比如Base.metadata.bind = engine）。

按照上面的步骤排查，应该能解决这个错误。官方文档的例子是可行的，大概率是你的schema或者外键配置的小细节没对齐。

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