FastAPI中SQLModel报NoForeignKeysError问题求助

核心原因 #

拆分文件后，循环导入导致SQLAlchemy/SQLModel在运行时无法识别跨文件的外键关联，加上未显式指定表所在的geog schema，进一步加剧了关联识别失败。

具体修复步骤 #

1. 显式指定模型的schema #

每个模型都要通过__table_args__指定所属的geog schema，确保SQLModel能定位到正确的表：

# units.py
from sqlmodel import SQLModel, Field

class Unit(SQLModel, table=True):
    __tablename__ = "units"
    __table_args__ = {"schema": "geog"}
    id: int = Field(primary_key=True)
    name: str

2. 用带schema的字符串定义外键 #

在projections.py中，外键字段必须使用完整的schema+表+字段字符串，不能直接引用跨文件的模型类属性（TYPE_CHECKING导入仅用于类型提示，运行时不生效）：

# projections.py
from typing import TYPE_CHECKING
from sqlmodel import SQLModel, Field

if TYPE_CHECKING:
    from .units import Unit

class Projection(SQLModel, table=True):
    __tablename__ = "projections"
    __table_args__ = {"schema": "geog"}
    id: int = Field(primary_key=True)
    epsg_code: int
    # 显式指定带schema的外键路径
    unit_id: int = Field(foreign_key="geog.units.id")
    # 关系字段用TYPE_CHECKING导入的类型做提示
    unit: "Unit" = Field(foreign_key="geog.units.id")

3. 避免循环导入问题 #

不要在非TYPE_CHECKING块中导入跨文件的模型，所有跨文件的类型引用都放在if TYPE_CHECKING:块内，运行时通过字符串外键定义建立关联。

验证修复 #

重新运行CRUD操作时，SQLAlchemy会正确识别geog schema下的外键约束，不会再触发NoForeignKeysError。

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