Pydantic数据类为何将列表转为字典？如何阻止该行为？

问题原因 #

你碰到的情况是Pydantic的隐式类型转换机制在起作用：当输入类型和字段声明的dict不匹配时，Pydantic会尝试自动转换类型。对于dict字段，它会把可迭代对象（比如列表）当作键值对集合来转成字典——如果列表里的元素是字典，就会被拆解成键值对再合并。

你传入的[{'a':'b', 'c':'d'}]是个包含单个字典的列表，旧版本Pydantic在转换时会把这个字典的键当作键值对的“键”和“值”（比如'a'作为键，'c'作为值），最终得到{'a': 'c'}。这种转换显然不符合预期，属于旧版本类型转换的疏漏，新版本Pydantic通常会直接抛出类型错误。

这不是合理的预期行为，本质是隐式转换触发了非预期的解析逻辑。

解决办法 #

要禁止这种自动转换，强制严格校验输入类型，有几种可行方案：

1. 使用StrictDict严格类型 #

Pydantic提供了严格类型StrictDict，它会强制要求输入必须是字典，不允许任何隐式转换：

from pydantic.dataclasses import dataclass
from pydantic.types import StrictDict

@dataclass
class X:
    y: StrictDict

此时再传入字典列表会直接抛出ValidationError，明确提示类型不匹配。

2. 启用严格模式（Pydantic V2） #

如果用的是Pydantic V2，给数据类加上strict=True参数，全局禁用所有隐式类型转换：

from pydantic.dataclasses import dataclass

@dataclass(strict=True)
class X:
    y: dict

所有字段都会严格校验类型，不符合的输入直接触发验证错误。

3. 自定义字段验证器 #

如果需要更灵活的控制，可以给字段加自定义验证器，确保输入只能是字典：

from pydantic.dataclasses import dataclass
from pydantic import field_validator

@dataclass
class X:
    y: dict

    @field_validator('y')
    def enforce_dict_type(cls, value):
        if not isinstance(value, dict):
            raise TypeError('字段y必须是字典类型')
        return value

这种方式完全自定义校验逻辑，能精准控制输入类型。

总结 #

你遇到的是Pydantic隐式转换导致的非预期行为，通过上述三种方法都能阻止自动转换，确保y字段只接受合法的字典输入。

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