如何为Pydantic子类的每个实例生成独立UUID？

问题分析 #

你遇到的三个方案的问题其实都是因为没贴合Pydantic的设计逻辑：

• 直接重写__init__却没调用父类初始化方法，破坏了Pydantic对字段的管理流程，导致__fields_set__这类内部属性出错；
• 把__init__定义成类方法是完全误用——__init__是实例初始化方法，类方法操作的是类属性，自然会让子类实例拿不到独立的id_，还覆盖了Pydantic默认的字段初始化逻辑；
• 直接给id_赋值uuid4()的问题在于，Python加载类定义时就会执行这个函数并把结果作为默认值，所以所有实例共享同一个UUID，这是Python模块加载的特性，不是Pydantic的问题。

最优解决方案：使用Pydantic的default_factory #

Pydantic专门提供了default_factory参数处理动态生成的默认值，完美匹配你的需求——每次创建实例时自动调用函数生成新UUID，且无需在子类中重复任何逻辑。

实现代码非常简洁：

from uuid import uuid4, UUID
from pydantic import BaseModel, Field

class Foo(BaseModel):
    # 用Field的default_factory传入uuid4函数，每次实例化都会调用它生成新UUID
    id_: UUID = Field(default_factory=uuid4)

class Bar(Foo):
    pass

class Spam(Foo):
    pass

if __name__ == '__main__':
    b1 = Bar()
    print(b1.id_)  # 示例输出：a1b2c3d4-...（唯一值）
    b2 = Bar()
    print(b2.id_)  # 和b1完全不同的UUID
    s1 = Spam()
    print(s1.id_)  # 又是一个新的UUID

为什么这个方案好用？ #

1. 符合Pydantic设计：default_factory是官方推荐的动态默认值实现方式，不会破坏Pydantic的内部字段管理逻辑；
2. 无需重复代码：所有子类自动继承这个逻辑，完全符合你希望的继承设计理念；
3. 扩展性强：如果之后需要自定义UUID生成规则（比如加入业务前缀、使用特定版本的UUID），只需要替换default_factory传入的函数即可，比如：

def generate_business_uuid():
    # 自定义逻辑：比如生成带特定前缀的UUID（示例）
    return uuid4()

class Foo(BaseModel):
    id_: UUID = Field(default_factory=generate_business_uuid)

备选方案：正确重写__init__（不推荐，但可了解） #

如果你一定要通过重写__init__实现，必须记得调用父类的__init__方法，保证Pydantic的字段初始化流程正常执行：

from uuid import uuid4, UUID
from pydantic import BaseModel

class Foo(BaseModel):
    id_: UUID | None = None

    def __init__(self, **kwargs):
        # 先让Pydantic处理所有字段初始化
        super().__init__(**kwargs)
        # 如果id_没有被显式赋值，就生成新的UUID
        if self.id_ is None:
            self.id_ = uuid4()

不过这个方案比default_factory繁琐，且容易因为忘记处理边界情况（比如用户显式传入了id_）出问题，所以优先推荐default_factory的方式。

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