如何定义Pydantic模型从ORM对象提取嵌套属性并使用model_validate？

针对你需要提取嵌套对象字段作为顶层字段，同时保持使用.model_validate()的需求，Pydantic v2提供了几个原生方案，无需自定义from_orm()，代码简洁且复用性强：

1. 使用AliasPath直接映射嵌套路径 #

这是最直接的方案，通过Field(validation_alias=AliasPath(...))指定嵌套属性的路径，让Pydantic在验证时自动从嵌套对象中提取值。

示例代码： #

# 假设的ORM模型
class Organization:
    def __init__(self, name: str):
        self.name = name

class Employee:
    def __init__(self, id: int, name: str, organization: Organization):
        self.id = id
        self.name = name
        self.organization = organization

# 响应模型定义
from pydantic import BaseModel, Field, AliasPath

class EmployeeListItemResponse(BaseModel):
    id: int
    name: str
    # 直接映射employee.organization.name到顶层字段organization_name
    organization_name: str = Field(validation_alias=AliasPath('organization', 'name'))
    # 开启ORM属性支持，确保能正确读取ORM对象的属性
    model_config = {'from_attributes': True}

# 使用方式
emp = Employee(1, "John Doe", Organization("Tech Corp"))
response = EmployeeListItemResponse.model_validate(emp)
print(response.dict())
# 输出: {'id': 1, 'name': 'John Doe', 'organization_name': 'Tech Corp'}

这个方案完全兼容.model_validate()，不需要额外逻辑，和普通模型用法一致，维护成本极低。

2. 使用computed_field处理复杂派生字段 #

如果需要的不仅仅是简单提取，而是要对嵌套字段做计算（比如拼接、转换格式），可以用Pydantic v2.2+新增的@computed_field装饰器。

示例代码： #

from pydantic import BaseModel, computed_field

class EmployeeListItemResponse(BaseModel):
    id: int
    name: str
    # 先读取嵌套的organization对象（后续计算用）
    organization: Organization
    model_config = {'from_attributes': True, 'exclude': ['organization']}  # 默认排除原始嵌套字段

    @computed_field(return_type=str)
    def organization_name(self) -> str:
        # 这里可以添加任意计算逻辑，比如拼接前缀
        return f"[{self.organization.name}]"

# 使用方式
emp = Employee(1, "John Doe", Organization("Tech Corp"))
response = EmployeeListItemResponse.model_validate(emp)
print(response.dict())
# 输出: {'id': 1, 'name': 'John Doe', 'organization_name': '[Tech Corp]'}

通过model_config的exclude参数，可以默认隐藏用于计算的原始嵌套字段，避免返回冗余数据。

3. 复用通用映射逻辑 #

如果多个模型需要重复提取相同的嵌套路径，可以把AliasPath封装成常量，实现复用：

# 定义通用路径常量
ORG_NAME_PATH = AliasPath('organization', 'name')

# 多个模型复用该路径
class EmployeeListItemResponse(BaseModel):
    id: int
    name: str
    organization_name: str = Field(validation_alias=ORG_NAME_PATH)
    model_config = {'from_attributes': True}

class DepartmentEmployeeResponse(BaseModel):
    employee_id: int
    employee_name: str
    org_name: str = Field(validation_alias=ORG_NAME_PATH)
    model_config = {'from_attributes': True}

这种方式可以避免重复编写路径，提升代码可维护性。

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