Pydantic ORM模式下多层嵌套关联的跨层字段映射问题解决

问题本质 #

Pydantic ORM模式（v1为orm_mode=True，v2为from_attributes=True）默认仅读取当前ORM实例的直接属性、直接挂载的关联对象，不会自动沿着多层relationship链路逐层检索目标字段。当前业务的ORM关联链路为Grade → 一级关联Result → 二级关联Student，如果直接在GradeSchemaOut声明student字段，Pydantic会尝试在Grade实例上查找同名直接属性，自然会因为字段不存在抛出异常。

可落地的实现方式 #

1. 自定义校验器实现跨层取值（改动最小，无需改动原有ORM结构） #

通过Pydantic的根校验器，在模型初始化阶段直接沿着已知的关联路径提取跨层字段，完全兼容原有代码的定义结构，不需要调整响应返回格式。
示例代码：

from pydantic import root_validator
from schemas.base import BaseSchema
from schemas.student import StudentOutSchema

class GradeSchemaOut(BaseSchema):
    score: float
    student: StudentOutSchema

    class Config:
        orm_mode = True

    @root_validator(pre=True)
    def parse_cross_level_relation(cls, input_value):
        # 适配ORM实例传入场景（即调用from_orm时的入参）
        if hasattr(input_value, "result") and hasattr(input_value.result, "student"):
            # 手动拆解跨层字段为Pydantic可识别的字段映射
            return {
                "score": input_value.score,
                "student": input_value.result.student
            }
        # 兼容直接传字典的初始化场景
        return input_value

注：如果使用Pydantic v2版本，将@root_validator(pre=True)替换为@model_validator(mode="before")即可，核心逻辑完全一致。

这种方式不需要修改任何SQLAlchemy层的代码，也能保证输出的Schema结构和最初设计完全一致，是跨层映射场景下最常用的实现。

2. Schema结构和ORM关联层级完全对齐（零自定义逻辑，维护成本最低） #

放弃硬跨层取数的设计，让Pydantic模型的嵌套结构和SQLAlchemy的关联层级完全匹配，完全依靠Pydantic ORM模式的默认能力完成序列化，不需要额外编写校验逻辑。
示例代码：

class ResultSchemaOut(BaseSchema):
    student: StudentOutSchema
    class Config:
        orm_mode = True

class GradeSchemaOut(BaseSchema):
    score: float
    result: ResultSchemaOut  # 和ORM层Grade.result的关联完全对齐
    class Config:
        orm_mode = True

如果前端要求最终响应必须把student放在Grade层级下，可以在该结构基础上，通过序列化钩子做字段扁平化处理，不需要再处理ORM关联的取值逻辑。

3. SQLAlchemy层打通跨层关联（Pydantic代码零改动） #

在SQLAlchemy的Grade模型上新增只读的跨层关联，直接把Student关联挂载到Grade实例上，相当于在ORM层就打通了从Grade到Student的快捷访问路径，这时候原有Pydantic代码不需要做任何修改，就能直接通过ORM模式读取到student字段。
对应ORM层的修改示例：

class Grade(BaseModel):
    result_id = Column(UUIDType, ForeignKey("result.id"), nullable=False)
    score = Column(Float)

    result = relationship("Result", back_populates="grades")
    # 新增跨层只读关联，不影响原有ORM的写入、更新逻辑
    student = relationship(
        "Student",
        primaryjoin="Grade.result_id == Result.id",
        secondaryjoin="Result.student_id == Student.id",
        secondary="result",
        viewonly=True,
        uselist=False
    )

修改完成后，Grade实例会自带直接访问的student属性，Pydantic读取时不需要额外处理就能正常序列化。

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