field_validator跨字段校验实用技巧

Pydantic 中的 `field_validator` 无法安全实现跨字段校验，因其仅接收当前字段值，强行访问其他字段会触发 AttributeError；真正可靠且推荐的做法是使用 `model_validator(mode='after')`——它在所有字段完成基础解析后执行，可通过 `self` 直接访问已验证的全部字段，轻松实现如“付费时金额必填”等业务逻辑，同时规避了误用 `info.data`（v2 中已移除）、硬编码字段名或侵入式上下文传参等常见陷阱，是构建健壮、可维护数据校验逻辑的唯一正解。

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')，其他路子要么失效，要么埋雷。

终于介绍完啦！小伙伴们，这篇关于《field_validator跨字段校验实用技巧》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！