如何在Pydantic V2中自动填充模型字段？

问题场景 #

我有如下Pydantic模型：

from pydantic import BaseModel

class MyModel(BaseModel):
    url: str
    id: str

希望通过URL中的数据自动填充id字段，达到以下效果：

url = 'https://www.example.com/open-requests/myid123'

instance = MyModel(url=url)
print(instance.id)  # 'myid123'

用dataclasses时通常会重写__post_init__实现，但这种方式需要把id设为str | None = None，而我不想修改id的类型定义，该怎么实现？

解决方案 #

方法1：使用Pydantic的model_post_init生命周期方法 #

Pydantic提供了官方的后置初始化方法model_post_init，在模型实例化完成后执行，无需将id设为可选类型：

from pydantic import BaseModel

class MyModel(BaseModel):
    url: str
    id: str

    def model_post_init(self, __context) -> None:
        # 从URL的最后一段提取id
        self.id = self.url.split('/')[-1]

测试验证：

url = 'https://www.example.com/open-requests/myid123'
instance = MyModel(url=url)
print(instance.id)  # 输出: myid123

这种方式贴合Pydantic的生命周期设计，既保留了id的严格类型定义，又能自动完成赋值。

方法2：使用计算字段（Pydantic v2.6+） #

如果id完全由url派生、不需要用户手动传入，推荐使用计算字段，代码更简洁：

from pydantic import BaseModel, computed_field

class MyModel(BaseModel):
    url: str

    @computed_field
    @property
    def id(self) -> str:
        return self.url.split('/')[-1]

测试验证：

url = 'https://www.example.com/open-requests/myid123'
instance = MyModel(url=url)
print(instance.id)  # 输出: myid123
# 序列化时会自动包含id字段
print(instance.model_dump())
# 输出: {'url': 'https://www.example.com/open-requests/myid123', 'id': 'myid123'}

计算字段会自动基于url生成id，无需额外的初始化逻辑，同时id的类型依然是严格的str。

内容的提问来源于stack exchange，提问作者Zack Plauché