如何让mypy兼容Pydantic field_validator修改字段类型的场景？

原代码中mypy报错的核心原因是：字段x的类型注解声明为int，mypy据此判定只能传入int类型参数，但mode="before"的验证器实际允许传入str并转换为int，二者的类型约束不匹配。以下是两种可行的解决方法：

方法一：用Annotated明确字段的输入类型范围 #

通过Annotated结合联合类型（Union或|），声明字段既接受int也接受str作为输入，同时保留最终的字段类型为int。这样mypy能识别合法的输入类型，Pydantic也能正常执行类型转换逻辑。

写法1：内联验证逻辑 #

from typing import Annotated, Union
from pydantic import BaseModel, BeforeValidator

class MyModel(BaseModel):
    x: Annotated[int, BeforeValidator(lambda v: len(v) if isinstance(v, str) else v)]

# mypy不再报错
MyModel(x='test')
MyModel(x=123)

写法2：保留独立验证函数 #

如果需要复用验证逻辑，可以保留原有的类方法：

from typing import Annotated, Union
from pydantic import BaseModel, BeforeValidator

class MyModel(BaseModel):
    @classmethod
    def to_int(cls, v: str | int) -> int:
        return len(v) if isinstance(v, str) else v

    x: Annotated[int, BeforeValidator(to_int)]

MyModel(x='test')

方法二：临时添加类型忽略注释（不推荐） #

如果只是临时绕过mypy检查，可以在实例化代码后添加# type: ignore注释，但这种方法会掩盖潜在的类型问题，仅适合临时调试场景：

MyModel(x='test')  # type: ignore

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