pydanticfield_validator跨字段校验方法详解

Pydantic 中实现安全可靠的跨字段依赖校验，核心在于正确选用 `model_validator(mode='after')` 而非 `field_validator`：后者仅作用于单字段值，强行访问其他字段会因 `info.data` 在 v2 中已被移除而触发 AttributeError；而 `model_validator(mode='after')` 在所有字段完成基础解析后执行，可通过 `self` 直接、安全地访问全部已验证字段，天然支持如“paid 为 True 时 amount 必须存在”等业务逻辑，并能优雅处理动态字段遍历与错误聚合——这是官方推荐、稳定无坑的唯一正解。

field_validator 能不能做跨字段校验？

不能直接做——field_validator 默认只接收当前字段的值，不带 info.context 或完整模型实例，拿不到其他字段。硬写会报 AttributeError: 'ValidationInfo' object has no attribute 'data' 或类似错误。

用 model_validator 替代 field_validator 做跨字段检查

真正该用的是 model_validator(mode='after')：它接收完整的模型实例（即 self），所有已解析字段都可直接访问，适合实现“若 A 为 True，则 B 必须非空”这类逻辑。

• 必须加 mode='after'，否则默认是 'before'，此时字段还没解析，self 里只有原始输入字典
• 校验失败时抛 ValueError 或 AssertionError，Pydantic 会自动转成标准错误
• 注意：如果依赖字段本身校验失败（比如类型错、缺失），model_validator 不会执行——它只在所有字段通过基础校验后才运行

from pydantic import BaseModel, model_validator

class Order(BaseModel):
    paid: bool
    amount: float | None = None

    @model_validator(mode='after')
    def check_amount_if_paid(self):
        if self.paid and self.amount is None:
            raise ValueError('amount is required when paid=True')
        return self

field_validator 配合 info.data 的陷阱

旧版 Pydantic v1 有 values 参数，v2 中有人误以为 info.data 存在——其实没有。v2 的 ValidationInfo 对象只有 context、data 是被移除的属性，强行访问会报 AttributeError。

• 别写 info.data['other_field'] —— 这段代码在 v2 中永远失败
• 如果真要从上下文传数据，得手动通过 context 注入，但这是侵入式设计，不推荐用于字段间逻辑耦合
• 跨字段规则越复杂，越应归到 model_validator，而不是拆到多个 field_validator 里互相猜状态

需要动态字段名时怎么写 model_validator？

比如“任意以 _url 结尾的字段，值必须以 https:// 开头”，这时不能硬编码字段名，得遍历 self.__pydantic_core_schema__？不用。更简单：直接读 self.__dict__ 或用 self.model_dump()，但注意前者含私有属性，后者触发序列化开销。

• 推荐用 self.model_fields_set + self.__dict__ 筛出已设置的字段
• 或直接用 self.model_dump(exclude_unset=True) 获取干净字典
• 避免在 model_validator 里调 self.model_dump_json() 这类重操作，容易引发循环或性能问题

跨字段校验的本质不是“怎么取值”，而是“在哪取最安全”——答案始终是 model_validator(mode='after')，其他路子要么失效，要么埋雷。

好了，本文到此结束，带大家了解了《pydanticfield_validator跨字段校验方法详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！