FastAPI项目遇SQLAlchemy NoForeignKeysError错误，求排查解决

错误根源 #

触发NoForeignKeysError的核心问题是**ServiceKey模型中version_id字段的外键指向错误**：你当前写的是ForeignKey('version.id')，但ServiceVersion对应的数据库表名是serviceversion，并非version，SQLAlchemy无法找到对应的关联表，因此无法确定ServiceVersion和ServiceKey之间的连接条件。

修正步骤 #

修改models.py中的ServiceKey类，将version_id的外键指向正确的表：

class ServiceKey(Base):
    __tablename__ = 'servicekey'

    id = Column(Integer, primary_key=True, index=True)
    service_id = Column(Integer, ForeignKey('service.id'))
    # 修正外键指向，改为对应serviceversion表的id字段
    version_id = Column(Integer, ForeignKey('serviceversion.id'))
    service_key = Column(String)
    service_value = Column(String)

    service = relationship('Service', back_populates='servicekey')
    serviceversion = relationship('ServiceVersion', back_populates='servicekeyversion')

额外注意事项 #

• 确认所有关系的back_populates参数匹配：当前ServiceVersion.servicekeyversion和ServiceKey.serviceversion的对应关系是正确的，修正外键后即可正常建立关联。
• 若使用数据库迁移工具（如Alembic），需要生成新的迁移脚本并执行，确保数据库表结构同步更新。

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