PyCharm中Pydantic validator装饰器警告及验证失效问题咨询

一、初始代码的PyCharm警告原因 #

初始代码中，你给验证方法同时使用了@validator("num")和@classmethod装饰器，且顺序是@validator在前、@classmethod在后：

from pydantic import BaseModel, validator


class Request(BaseModel):
    num: int

    @validator("num")
    @classmethod
    def validate_num(cls, num: int) -> int:
        return num

PyCharm的警告含义是：@validator装饰器没有接收到它预期的可调用对象。因为@classmethod是内置装饰器，它会将普通函数转换为特殊的类方法对象，而Pydantic的@validator装饰器设计为直接修饰普通函数，内部会自动将目标方法转换为类方法供验证逻辑使用。你颠倒了装饰器顺序，导致@validator处理的是@classmethod返回的特殊对象而非原始函数，因此触发警告。

二、修改后验证逻辑失效的原因及解决办法 #

失效原因 #

你调整了装饰器顺序，把@classmethod放在@validator之前：

@classmethod
@validator("num")
def validate_num(cls, num: int) -> int:
    if num < 0:
        raise RequestValidationError([ErrorWrapper(ValueError("error"), ())])
    return num

这种写法会让@validator先修饰普通函数，再由@classmethod二次包装。但Pydantic的验证器注册机制依赖于@validator装饰器内部的逻辑来识别和绑定验证方法，手动添加的@classmethod会干扰这个注册过程，导致Pydantic无法识别该方法为验证器，因此实例化Request对象时不会执行你的验证逻辑。

另外，你在模型内部抛出RequestValidationError也是错误的——这是FastAPI用于捕获Pydantic验证错误后向外抛出的异常，并非Pydantic模型内部验证时应使用的异常类型。

解决办法 #

1. 移除手动添加的@classmethod装饰器：Pydantic的@validator会自动将被修饰的方法转换为类方法，无需手动声明。
2. 使用Pydantic原生的错误抛出方式：在验证方法中直接抛出ValueError（或其他内置异常），Pydantic会自动将其包装为ValidationError。

修正后的代码如下：

from pydantic import BaseModel, validator, ValidationError


class Request(BaseModel):
    num: int

    @validator("num")
    def validate_num(cls, num: int) -> int:
        if num < 0:
            raise ValueError("num不能为负数")
        return num


try:
    request = Request(num=-2)
except ValidationError as e:
    print(e)

运行这段代码会正确触发验证错误，输出类似：

1 validation error for Request
num
  num不能为负数 (type=value_error)

如果需要在FastAPI中处理这个错误，FastAPI会自动捕获Pydantic的ValidationError并转换为RequestValidationError返回给客户端，无需在模型内部手动抛出。

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