如何解决FastAPI与SQLModel中的循环依赖问题？

根据错误栈，核心问题是Routine、RoutineSection、RoutineStep以及Operation之间形成了模块导入循环，以下是几种可靠的解决方法：

1. 使用字符串引用模型类（最推荐） #

SQLModel和Pydantic支持用字符串形式的类名替代直接导入，避免模块加载时的循环引用。具体操作：

• 移除模型文件顶部的循环导入语句
• 在Relationship定义中用字符串引用关联类
• 若需要在模块内使用关联类，可在文件末尾添加延迟导入并更新引用

修改示例： #

app/models/routine.py

from typing import Optional, List
from pydantic import UUID4
from datetime import datetime
from sqlmodel import Field, Relationship, SQLModel
import uuid

# 移除循环导入语句
# from .routine_section import RoutineSection
# from .routine_step import RoutineStep

class Routine(SQLModel, table=True):
  id: Optional[UUID4] = Field(default_factory=uuid.uuid4, primary_key=True)
  name: Optional[str] = None
  description: Optional[str] = None
  operation_id: Optional[UUID4] = Field(None, foreign_key="operations.id")
  # 用字符串引用关联类
  sections: List["RoutineSection"] = Relationship(back_populates="routine", sa_relationship_kwargs={"order_by": "RoutineSection.routine_id"})
  steps: List["RoutineStep"] = Relationship(back_populates="routine", sa_relationship_kwargs={"order_by": "RoutineStep.position"})

# 可选：若模块内需要使用关联类，添加延迟导入并更新引用
from .routine_section import RoutineSection
from .routine_step import RoutineStep
Routine.update_forward_refs()

app/models/routine_step.py

from typing import Optional
from pydantic import UUID4
from sqlmodel import Field, Relationship, SQLModel

# 移除循环导入语句
# from .routine import Routine

class RoutineStep(SQLModel, table=True):
  id: Optional[UUID4] = Field(default_factory=uuid.uuid4, primary_key=True)
  position: int = Field(default=0)
  routine_id: Optional[UUID4] = Field(None, foreign_key="routine.id")
  # 用字符串引用关联类
  routine: Optional["Routine"] = Relationship(back_populates="steps")

# 可选：添加延迟导入并更新引用
from .routine import Routine
RoutineStep.update_forward_refs()

app/models/operation.py

同样处理和Routine的循环：

# 移除from .routine import Routine
# ... 其他代码 ...
class Operation(SQLModel, table=True):
  # ... 字段定义 ...
  # 用字符串引用Routine
  routines: List["Routine"] = Relationship(back_populates="operation")

# 可选：延迟导入并更新引用
from .routine import Routine
Operation.update_forward_refs()

2. 调整models/__init__.py的导入顺序 #

将循环链中最基础的模型放在最前面导入，比如先导入Routine，再导入RoutineSection、RoutineStep，最后导入Operation：

# app/models/__init__.py
from .routine import Routine
from .routine_section import RoutineSection
from .routine_step import RoutineStep
from .operation import Operation
# ... 其他模型导入 ...

注意：该方法可靠性低于字符串引用，若后续模型关系变更可能再次触发循环。

3. 延迟导入到函数内部 #

如果某些模型仅在特定函数中使用（比如查询逻辑），可以将导入语句从模块顶部移到函数内部：

# 示例：在operation.py的查询函数中延迟导入
def get_operation_routines(session: Session, operation_id: UUID4):
    from .routine import Routine
    return session.exec(select(Routine).where(Routine.operation_id == operation_id)).all()

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