field_validator不能校验多个字段间的依赖关系,因其仅接收单个字段值且self不可用;可靠方式是使用model_validator(mode="after")访问已验证的完整实例。

field_validator 能不能校验多个字段之间的依赖关系
不能直接实现跨字段依赖校验。field_validator 默认只接收单个字段的值(即当前字段的 raw 值),不自动传入其他字段,因此无法在装饰单个字段时安全访问 self 或其他字段——此时模型实例尚未构建完成,self 不可用。
为什么用 @field_validator(mode="before") 也拿不到其他字段
即使指定 mode="before",field_validator 仍只作用于单个字段的输入值(比如字典中该 key 对应的原始值),接收参数仍是 value, info: ValidationInfo。虽然 info.data 在某些场景下可能包含已解析的其他字段,但这属于未公开行为、不可靠:
-
info.data的内容取决于字段声明顺序和解析阶段,顺序靠后的字段 validator 中,info.data可能为空或只有部分字段 - Pydantic 官方文档明确指出:
info.data是“best-effort”,不应作为依赖校验的依据 - 在嵌套模型、泛型或使用
validate_default=True时,info.data行为更难预测
真正可靠的跨字段依赖校验该怎么做
必须使用 model_validator(Pydantic v2 推荐)或旧版 root_validator(v1):
-
model_validator(mode="before"):接收原始输入(如 dict),适合检查字段是否存在、类型是否匹配等前置逻辑 -
model_validator(mode="after"):接收已初步验证的模型实例self,可安全访问所有字段,是做业务级依赖校验(如 “end_time 必须大于 start_time”)的唯一可靠方式 - 示例:
from pydantic import BaseModel, model_validator class Event(BaseModel): start_time: int end_time: int @model_validator(mode="after") def end_after_start(self) -> "Event": if self.end_time <= self.start_time: raise ValueError("end_time must be greater than start_time") return self
field_validator 还有没有可能“曲线救国”
极少数边界情况可以勉强利用 info.data,但仅限于:字段顺序固定、无嵌套、且你完全控制输入结构。例如:
- 两个平级字段 A 和 B,A 先声明,B 的
@field_validator(mode="before")中尝试读info.data.get("A") - 这依赖 A 已被解析且无错误,一旦 A 校验失败,B 的 validator 甚至不会触发
- 这种写法脆弱、难测试、违反单一职责,上线后容易因字段重排或新增字段而静默失效
真要校验依赖,别绕弯——model_validator(mode="after") 是设计上就为此存在的机制,其余都是权宜之计。










