如何在Pydantic的ORM模式下结合验证器处理默认值且不修改SQLAlchemy实例

我完全懂你的痛点——直接改SQLAlchemy实例的属性会被session追踪，一不小心就把临时的兜底名称持久化到数据库里，而expunge又会搞砸关联订单的懒加载，确实挺闹心的。这里有几个常用的解决方案，你可以根据自己的场景挑选：

方案一：先转成字典再处理，彻底隔离ORM实例 #

核心思路是先把SQLAlchemy实例的属性提取成字典，在字典层面修改name，再传给Pydantic模型验证。这样完全不会触碰原ORM实例，自然也就不会有意外持久化的问题。

from sqlalchemy import inspect

db_customer: CustomerModel = get_customer_from_db(some_id)
# 用inspect安全获取ORM实例属性，避免直接访问私有字段
customer_attrs = {attr.key: attr.value for attr in inspect(db_customer).attrs}
# 手动关联orders字段，因为inspect默认不会包含关系属性
customer_attrs["orders"] = db_customer.orders

# 给name加兜底值
if not customer_attrs.get("name"):
    customer_attrs["name"] = generate_fallback_name(db_customer)

return Customer.model_validate(customer_attrs)

方案二：用Pydantic的「before」模式验证器 #

把验证器的模式从wrap改成before，这样Pydantic会先把ORM实例转换成内部的属性字典（而非直接给你原始ORM实例），你可以在这个字典上修改name，完全不会影响原ORM对象。

import typing as t
from pydantic import model_validator

class Customer(BaseModel):
    orders: list[Order]
    name: str

    model_config = ConfigDict(from_attributes=True)

    @model_validator(mode="before")
    @classmethod
    def add_fallback_name(cls, input_data: t.Any) -> t.Any:
        # 兼容两种输入情况：ORM实例或属性字典
        if hasattr(input_data, "name"):  # 判断是否为ORM实例
            # 不修改原实例，而是创建新字典
            data_dict = {
                "id": input_data.id,
                "orders": input_data.orders,
                "name": input_data.name or generate_fallback_name(input_data)
            }
            return data_dict
        elif isinstance(input_data, dict):
            if not input_data.get("name"):
                input_data["name"] = generate_fallback_name(input_data)
            return input_data
        return input_data

方案三：拆分Pydantic模型，用中间层隔离 #

定义两个Pydantic模型：一个严格映射SQLAlchemy的结构（包括可选的name），另一个负责处理业务逻辑（比如把name设为必填并加兜底）。中间层的模型是纯Pydantic对象，修改它不会影响SQLAlchemy实例。

class CustomerBase(BaseModel):
    id: UUID
    orders: list[Order]
    name: str | None = None

    model_config = ConfigDict(from_attributes=True)

class Customer(CustomerBase):
    name: str

    @model_validator(mode="before")
    @classmethod
    def add_fallback_name(cls, values: t.Any) -> t.Any:
        if isinstance(values, CustomerBase) and not values.name:
            # 修改的是Pydantic实例，和SQLAlchemy完全无关
            values.name = generate_fallback_name(values)
        elif isinstance(values, dict) and not values.get("name"):
            values["name"] = generate_fallback_name(values)
        return values

使用时和原来一样简单：

db_customer: CustomerModel = get_customer_from_db(some_id)
return Customer.model_validate(db_customer)

这些方案的核心都是避免直接修改SQLAlchemy实例，要么在字典层面处理，要么在Pydantic中间模型上处理，既能实现你想要的兜底逻辑，又不会搞乱数据库里的原始数据。

备注：内容来源于stack exchange，提问作者Bram