Python 3.10.7下Pydantic可选字段验证器异常运行问题

环境信息

• Python版本：3.10.7
• 涉及文件：test.py、myinst.py

问题现象
运行test.py时，本应设为可选的somevar字段触发了RuntimeError，报错信息为this error should not show up because validator should not run on None；但合并两个文件代码或把myobj放在独立模块统一导入时无异常。

核心原因：跨模块同名类是不同对象，触发Pydantic类型转换与二次验证 #

1. Python类的模块唯一性：即使类名完全相同，不同模块中定义的类是完全独立的Python对象。test.py里的myobj和myinst.py里的myobj拥有不同的__module__属性，Pydantic会将它们视为两种不同的类型。
2. @validate_arguments的校验逻辑：当被装饰的函数参数使用Pydantic模型作为类型注解时，Pydantic会：
   • 检查传入对象是否是注解中模型类的实例；
   • 如果不是，会提取传入对象的字段数据，用这些数据实例化注解中的模型类，完成类型转换。
3. 验证错误的触发点：myinst是myinst.py中myobj的实例，而somefunc的参数注解是test.py中的myobj，两者类型不匹配。Pydantic会提取myinst的字段值（somevar=None），尝试创建test.py中myobj的实例，此时会触发该类的some_validator验证器，而你的验证器未处理var=None的情况，直接抛出错误。

注：Pydantic v1中@validator默认跳过None值验证，但这里是重新实例化模型，显式传入了从原实例提取的None值，会触发验证器执行。

解决方案 #

方案1：统一模型定义（推荐） #

将myobj的定义放在单独模块（比如models.py），在test.py和myinst.py中统一导入，确保两处使用的是同一个类：

models.py：

from typing import Optional
from pydantic import BaseModel, validator

class myobj(BaseModel):
    somevar: Optional[int] = None
    @validator("somevar")
    def some_validator(cls, var):
        if var is None:
            raise RuntimeError("this error should not show up because validator should not run on None")

myinst.py：

from models import myobj

myinst = myobj()

test.py：

from myinst import myinst
from pydantic import validate_arguments
from models import myobj

@validate_arguments
def somefunc(inst: myobj):
    pass

somefunc(myinst)

这样myinst与somefunc的参数注解类型完全匹配，不会触发类型转换和二次验证。

方案2：修改验证器，允许None值 #

在验证器上添加allow_none=True参数，明确允许字段为None时跳过验证，或在验证器内部处理None情况：

@validator("somevar", allow_none=True)
def some_validator(cls, var):
    # 仅当var不为None时执行验证逻辑
    if var is not None:
        # 示例：检查是否为正整数
        if var <= 0:
            raise ValueError("somevar must be positive")
    return var

方案3：关闭强制类型转换（不推荐） #

如果不需要Pydantic自动转换类型，可给@validate_arguments添加配置绕过类型校验：

@validate_arguments(config={"arbitrary_types_allowed": True})
def somefunc(inst: myobj):
    pass

该方案会失去类型检查的意义，仅适合特殊场景使用。

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