Pydantic V2混合原生类型与Annotated自定义类型时无法聚合全部验证错误的问题

看起来你的问题出在自定义验证器抛出的异常类型以及Pydantic的验证流程逻辑上，导致无法同时收集原生字段的验证错误和自定义验证的错误。让我一步步分析并给出解决方案：

问题根源分析 #

1. 自定义异常中断验证流程：你当前的validate_hostname抛出的是自定义的GenericParseException，而非Pydantic可识别的标准验证异常。当Pydantic运行到这个验证器并捕获到非标准异常时，会直接中断整个验证流程，转而抛出这个自定义异常，导致其他字段（比如api_token）的验证错误完全被忽略。
2. 错误分支互斥：你的错误处理逻辑中，不同异常分支是互斥的——要么捕获到ValidationError（原生字段错误），要么捕获到GenericParseException（自定义验证错误），无法同时收集两类错误。

解决方案 #

方案1：让自定义验证器抛出Pydantic可识别的异常 #

修改validate_hostname，抛出ValueError（Pydantic会自动将其转为ValidationError的字段错误），这样所有验证错误都会被Pydantic统一收集，不会中断验证流程：

def validate_hostname(value: str) -> str:
    if value.startswith("http://") or value.startswith("https://"):
        raise ValueError("base_url should not include the protocol (http:// or https://)")

    if not re.match(HOSTNAME_PATTERN, value):
        raise ValueError("Invalid hostname format.")

    return value

HostnameType = Annotated[str, AfterValidator(validate_hostname)]

这样当api_token缺失且base_url格式错误时，Pydantic会一次性抛出包含所有错误的ValidationError，你可以通过e.errors()拿到所有错误信息。

方案2：使用Pydantic原生@field_validator装饰器（更推荐） #

这种方式更贴合Pydantic的验证体系，所有错误会被自动聚合到ValidationError中，无需额外处理异常类型：

class Config(BaseModel):
    api_token: str
    base_url: str = BASE_URL

    @field_validator('base_url')
    @classmethod
    def validate_base_url(cls, value: str) -> str:
        if value.startswith("http://") or value.startswith("https://"):
            raise ValueError("base_url should not include the protocol (http:// or https://)")

        if not re.match(HOSTNAME_PATTERN, value):
            raise ValueError("Invalid hostname format.")

        return value

优化错误格式化逻辑 #

你当前的ValidationError错误收集逻辑直接使用e.errors()返回的字典列表，拼接后可读性很差。可以修改错误处理部分，将其格式化为你期望的字段名 - 错误信息格式：

def parse(self, config: dict[str, Any]) -> Config:
    errors: List[str] = []
    try:
        model = Config(**config)
        return model
    except ValidationError as e:
        # 格式化Pydantic原生验证错误为可读字符串
        for err in e.errors():
            # 提取字段名（比如从("api_token",)中取出"api_token"）
            field = err['loc'][0] if isinstance(err['loc'], tuple) and err['loc'] else 'unknown'
            errors.append(f"{field} - {err['msg']}")
    except GenericParseException as e:
        errors.append(f"Generic validation error: {e}")
    except Exception as e:
        errors.append(f"Unexpected error: {e}")
    finally:
        if errors:
            self.logger.error({
                'action': 'validation',
                'status': 'failed',
                'errors': errors
            })
            raise ConfigParseException("; ".join(errors))

为什么之前的方式不生效？ #

• 当自定义验证器抛出GenericParseException时，Pydantic无法将其纳入统一的ValidationError收集流程，会直接中断验证，导致其他字段的错误被完全忽略。
• 只有让自定义验证逻辑抛出Pydantic可识别的异常（如ValueError、TypeError或Pydantic官方的ValidationError），才能让所有错误被统一收集，实现你想要的错误聚合效果。

备注：内容来源于stack exchange，提问作者EldadT