如何让Pydantic v2的field_validator返回所有字段验证失败信息？

Pydantic v2 默认采用**快速失败（fast_fail）策略——只要遇到第一个验证错误就立即终止并返回，不会继续检查其他字段。要实现一次性返回所有字段的错误信息，你需要切换到收集所有错误（collect）**的验证策略，具体有两种实现方式：

1. 全局配置模型的错误策略 #

直接在模型类中通过model_config指定全局的错误收集策略，所有该模型的验证都会遵循这个规则：

from pydantic import BaseModel, field_validator

class Foo(BaseModel):
    name: str
    age: int

    # 核心配置：设置错误策略为收集所有错误
    model_config = {"error_strategy": "collect"}

    @field_validator("name", mode="after")
    def field_length(cls, value: str):
        if len(value) > 20:
            raise ValueError("名称长度不能超过20个字符！")
        return value

    @field_validator("age", mode="before")
    def cast_str_to_int(cls, value: str) -> int:
        if not value.isnumeric():
            raise ValueError("年龄必须是可转换为整数的字符串！")
        return int(value)

2. 单次验证临时指定策略 #

如果不想修改模型的全局配置，可以在调用验证方法时，临时传入error_strategy="collect"参数，仅对当前验证生效：

# 模拟同时存在两个字段错误的待验证数据
data = {"name": "abcdefghijklmnopqrstuvwxyz", "age": "not_a_valid_number"}

try:
    # 临时启用全错误收集
    foo_instance = Foo.model_validate(data, error_strategy="collect")
except Exception as e:
    # 打印所有错误详情
    print(e.errors())

效果说明 #

启用collect策略后，当多个字段验证失败时，Pydantic会收集所有错误并封装到ValidationError中，你可以通过errors()方法获取结构化的错误列表，包含每个错误的字段位置、错误类型和提示信息。

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