如何为Pydantic的construct函数参数替换Any类型提示？

要给construct函数的dictionary参数添加精确类型提示，核心是匹配传入字典的实际值类型（而非Pydantic最终解析后的类型），同时对应Model的字段结构。以下是两种可行方案：

方案一：使用TypedDict定义精确输入结构 #

TypedDict可以明确指定字典每个键对应的类型，完全匹配你传入的原始数据结构：

from typing import TypedDict
from datetime import datetime
from pydantic import BaseModel

class Model(BaseModel):
    timestamp: datetime
    number: int
    name: str

# 定义输入字典的类型：与传入的原始值类型对应
class ModelInput(TypedDict):
    timestamp: str  # 传入的是ISO格式字符串，Pydantic会自动转为datetime
    number: int
    name: str

def construct(dictionary: ModelInput) -> Model:
    return Model(**dictionary)

# 类型检查器会认可这个调用
construct({"timestamp": "2024-03-14T10:00:00Z", "number": 7, "name":"Model"})

这样类型检查器能准确识别每个键的类型，不会再出现类型不兼容的错误，同时Pydantic依然会自动将timestamp字符串解析为datetime对象。

方案二：允许更灵活的输入类型（可选） #

如果希望timestamp既可以传入字符串也可以直接传入datetime对象，可以在TypedDict中使用Union类型：

from typing import TypedDict, Union
from datetime import datetime
from pydantic import BaseModel

class Model(BaseModel):
    timestamp: datetime
    number: int
    name: str

class ModelInput(TypedDict):
    timestamp: Union[str, datetime]
    number: int
    name: str

# 两种调用方式都会被类型检查器认可
construct({"timestamp": "2024-03-14T10:00:00Z", "number": 7, "name":"Model"})
construct({"timestamp": datetime.now(), "number": 7, "name":"Model"})

为什么dict[str, str]不行？ #

你遇到的错误是因为dict[str, str]声明字典所有值都是字符串，但实际传入的number是整数类型，且类型检查器无法识别Pydantic对timestamp的自动转换逻辑，所以这种类型提示不符合实际输入结构。

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