Pydantic/SQLAlchemy双向模型循环引用问题：model_validate转换ORM实例时递归报错的解决方法

我完全懂你这种崩溃的感觉——双向关联的ORM转Pydantic模型时触发递归报错，简直是开发里的小陷阱！别着急，我给你整理了几个实用的解决方案，亲测有效：

方法一：用字段序列化器截断循环引用 #

这是最灵活的方式，你可以在Pydantic模型里通过field_serializer控制关联字段的序列化内容，主动切断循环链：

from pydantic import BaseModel, field_serializer

class Job(BaseModel):
    id: int | None = None
    user: "User" | None = None

    @field_serializer('user')
    def serialize_user(self, user: "User", _info):
        # 只序列化user的核心字段（比如id），不返回完整的user对象
        return {"id": user.id} if user else None

class User(BaseModel):
    id: int | None = None
    jobs: list["Job"] = []

    @field_serializer('jobs')
    def serialize_jobs(self, jobs: list["Job"], _info):
        # 序列化jobs时，只保留每个job的基础信息，跳过关联的user
        return [{"id": job.id} for job in jobs] if jobs else []

# 别忘了提前引用模型，或者用字符串标注类型
Job.model_rebuild()
User.model_rebuild()

这样当model_validate解析ORM实例时，只会处理你指定的字段，不会陷入双向引用的递归循环。

方法二：通过模型配置直接排除循环字段 #

如果你的场景比较简单，可以直接在Pydantic的model_config里指定要排除的循环字段路径，快速解决问题：

class User(BaseModel):
    id: int | None = None
    jobs: list["Job"] = []

    model_config = {
        'from_attributes': True,
        # 排除jobs列表中每个job的user字段，切断循环
        'exclude': {'jobs__user'}
    }

class Job(BaseModel):
    id: int | None = None
    user: "User" | None = None

    model_config = {
        'from_attributes': True,
        # 排除user关联的jobs字段
        'exclude': {'user__jobs'}
    }

这种方法代码量少，但字段路径的写法需要注意，适合结构简单的双向关联。

方法三：创建专用的序列化DTO模型 #

这是最推荐的长期解决方案——为不同的业务场景创建专门的Pydantic模型（也就是DTO，数据传输对象），避免双向引用：

# 基础模型：只包含核心字段，不带任何关联
class JobBase(BaseModel):
    id: int | None = None

class UserBase(BaseModel):
    id: int | None = None

# 带单向关联的模型：根据需求选择关联方向
class JobWithUser(JobBase):
    # 只关联用户的基础模型，不带用户的jobs字段
    user: UserBase | None = None

class UserWithJobs(UserBase):
    # 只关联任务的基础模型，不带任务的user字段
    jobs: list[JobBase] = []

之后转换ORM实例时，使用对应的DTO模型即可：

UserWithJobs.model_validate(db_user)

这种方式逻辑清晰，后续维护也方便，还能根据不同接口需求定制不同的模型结构。

方法四：在SQLAlchemy查询阶段控制关联加载 #

从根源上避免ORM实例携带双向关联数据，查询时通过SQLAlchemy的加载选项控制只加载需要的内容：

from sqlalchemy.orm import joinedload, defer

# 查询用户时，加载jobs但延迟加载每个job的user关联
db_user = session.query(UserORM).options(
    joinedload(UserORM.jobs).defer(JobORM.user)
).first()

# 或者只加载用户自身的字段，不加载jobs
db_user = session.query(UserORM).options(load_only(UserORM.id)).first()

这样ORM实例里的反向关联没有被初始化，model_validate自然不会触发递归。

总的来说，专用DTO模型是最适合复杂业务场景的方案，能从根本上避免循环引用的问题；如果只是临时解决，字段序列化器或模型配置排除的方法也能快速生效。

备注：内容来源于stack exchange，提问作者Zack Plauché