如何让自定义SpecialList在Pydantic中支持正常初始化与使用？

子类化标准list创建了带有double方法的SpecialList，并在Pydantic模型B中使用该类型存储A实例。直接调用double方法正常，但用字典初始化模型时触发ValidationError；尝试用@field_validator转换，却得到字典列表而非A实例列表。

代码示例：

class SpecialList(list):
    def double(self):
        for a in self:
            a.value_2 *= 2

from pydantic import BaseModel

class A(BaseModel):
    value_1: str
    value_2: int

class B(BaseModel):
    a: SpecialList[A] = SpecialList()
    
    class Config:
        arbitrary_types_allowed=True

错误信息：

ValidationError: 1 validation error for B
a
  Input should be an instance of SpecialList [type=is_instance_of, input_value=[{'value_1': 'X', 'value_2': 3}], input_type=list]

核心问题是Pydantic不会自动将普通列表转换为自定义的SpecialList类型，且arbitrary_types_allowed仅允许类型存在，不负责类型转换。需要先让Pydantic解析列表中的字典为A实例，再将整个列表包装为SpecialList。

方法：使用Annotated结合BeforeValidator #

通过BeforeValidator触发Pydantic的类型解析逻辑，先将字典列表转为A实例列表，再转换为SpecialList。

完整可运行代码：

from pydantic import BaseModel, Annotated, BeforeValidator

class SpecialList(list):
    def double(self):
        for a in self:
            a.value_2 *= 2

class A(BaseModel):
    value_1: str
    value_2: int

def convert_to_special_list(v, handler):
    # 先让Pydantic将输入解析为A实例的列表
    parsed_items = handler(v)
    # 包装为SpecialList实例
    return SpecialList(parsed_items)

class B(BaseModel):
    a: Annotated[SpecialList[A], BeforeValidator(convert_to_special_list)] = SpecialList()
    
    class Config:
        arbitrary_types_allowed = True

# 测试验证
if __name__ == "__main__":
    b = B(a=[{"value_1": "X", "value_2": 3}])
    print(b.a)  # 输出: [A(value_1='X', value_2=3)]
    print(type(b.a))  # 输出: <class '__main__.SpecialList'>
    b.a.double()
    print(b.a)  # 输出: [A(value_1='X', value_2=6)]

关键说明 #

1. BeforeValidator的handler参数会先处理输入列表，自动将每个字典转换为A实例，无需手动遍历转换。
2. arbitrary_types_allowed=True仍需保留，用于允许Pydantic识别自定义的SpecialList类型。
3. 此方案既解决了初始化时的验证错误，又保证了SpecialList中的元素是A实例，可正常调用double方法。

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