如何让Pydantic 1.X的数据转换兼容静态类型检查器？

在Pydantic 1.X（如1.10.12）中，我们可以通过带pre=True的预验证器在模型初始化时转换输入类型，但这类写法会和静态类型检查器（比如pyright）冲突——检查器会严格按照字段标注的类型校验传入参数，忽略预验证器的转换逻辑。

比如你给出的示例代码：

from pydantic import BaseModel, validator

class Foo(BaseModel):
    data: list[str]

    @validator("data", pre=True)
    def read_file(cls, v):
        if isinstance(v, str):
            with open(v) as fp:
                return fp.readlines()
        return v

Foo(data = ["a", "b"])
Foo(data = "/etc/hosts")  # pyright会报错：字符串无法赋值给list[str]类型参数

运行时完全正常，但pyright会抛出类型不兼容的错误。下面是几种无需冗余自定义构造器的解决方法：

方法一：用Union标注允许的输入类型 #

直接扩展字段的类型标注，明确告诉类型检查器该字段允许传入的所有输入类型，同时保留预验证器完成转换：

from typing import Union
from pydantic import BaseModel, validator

class Foo(BaseModel):
    # 标注允许传入字符串路径或字符串列表，最终存储为list[str]
    data: Union[list[str], str]

    @validator("data", pre=True)
    def read_file(cls, v):
        if isinstance(v, str):
            with open(v) as fp:
                return fp.readlines()
        return v

Foo(data=["a", "b"])
Foo(data="/etc/hosts")  # 类型检查器不再报错

这种方法最简单直接，不需要额外封装，适合单个字段的场景。模型实例的data字段在运行时依然是list[str]类型，不会影响后续逻辑。

方法二：封装自定义可转换类型 #

如果多个字段都需要类似“字符串路径转列表”的逻辑，可以封装一个自定义类型，统一处理转换逻辑，同时让类型检查器识别允许的输入：

from typing import List, Union
from pydantic import BaseModel, validator

class FilePathToList:
    @classmethod
    def validate(cls, v):
        if isinstance(v, list):
            return v
        if isinstance(v, str):
            with open(v) as fp:
                return fp.readlines()
        raise ValueError("输入必须是字符串列表或文件路径字符串")

class Foo(BaseModel):
    data: Union[List[str], str]

    @validator("data", pre=True)
    def convert_input(cls, v):
        return FilePathToList.validate(v)

把转换逻辑提取到自定义类后，多个字段可以复用同一个验证逻辑，减少代码重复。

总结 #

优先选择方法一，用Union扩展字段的输入类型标注，既能满足类型检查器的要求，又保留Pydantic的转换能力，代码简洁无冗余。如果有大量字段需要相同转换逻辑，再考虑封装自定义类型。

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