Pydantic v2 Fail Early机制失效？模型验证顺序异常咨询

Pydantic v2 默认会收集所有验证错误后再抛出，而 v1 是遇到第一个错误就终止验证流程，这是你遇到差异的核心原因。要恢复「提前终止」的行为，有两种实现方式：

1. 全局配置模型级别的提前终止 #

在 Root 模型中添加 model_config 配置，开启 stop_at_first_error：

from pydantic import BaseModel, field_validator
from typing import Literal


class SubModelA(BaseModel):
    string: Literal['a', 'b', 'c']


class SubModelB(BaseModel):
    integer: int


class Root(BaseModel):
    sub_model_a: SubModelA
    sub_model_b: SubModelB

    # 添加模型配置，开启提前终止
    model_config = {"stop_at_first_error": True}

    @field_validator('sub_model_b')
    @classmethod
    def validate_sub_model_b(cls, value, info):
        validated_a = info.data['sub_model_a']


if __name__ == "__main__":
    x = {
        'sub_model_a': {
            'string': 'invalid'
        },
        'sub_model_b': {
            'integer': 5
        }
    }

    y = Root(**x)

这样当 sub_model_a 验证失败时，会直接抛出错误，不会再执行 sub_model_b 的验证器逻辑。

2. 实例化时临时开启提前终止 #

如果不想修改模型的全局配置，可以在调用验证方法时传入参数：

if __name__ == "__main__":
    x = {
        'sub_model_a': {
            'string': 'invalid'
        },
        'sub_model_b': {
            'integer': 5
        }
    }

    # 调用 model_validate 并传入 stop_at_first_error 参数
    y = Root.model_validate(x, stop_at_first_error=True)

这种方式适合仅在特定场景下需要提前终止的情况。

补充说明 #

• 单独实例化 SubModelA 时会正常报错，是因为单个模型的验证默认就是遇到错误就终止，只有父模型在验证多个子模型字段时，v2 才会默认收集所有错误。
• 开启 stop_at_first_error 后，Pydantic 会在第一个验证错误发生时立即停止后续所有字段的验证流程，符合你期望的「Fail Early」行为。

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