Pydantic继承中自定义__init__函数的报错原因及原理解析

问题重现 #

你尝试在Pydantic中结合继承重写__init__，给父类fish和子类shark添加初始化额外操作，但第一次写法触发了验证错误：

第一次尝试代码：

from pydantic import BaseModel

class fish(BaseModel):
    name: str
    def __init__(self, name):
        super().__init__(name=name)
        print("Fish initialization successful!")
        

class shark(fish):
    color: str
    def __init__(self, name, color):
        super().__init__(name=name)
        self.color=color
        print("Shark initialization successful!")
        
f = fish(name="nemo")
print(f)
s = shark(name="bruce", color="grey")

运行报错：

Fish initialization successful!
name='nemo'
---------------------------------------------------------------------------
ValidationError                           Traceback (most recent call last)
Cell In[149], line 17
     15 f = fish(name="nemo")
     16 print(f)
---> 17 s = shark(name="bruce", color="grey")

Cell In[149], line 11, in shark.__init__(self, name, color)
     10 def __init__(self, name, color):
---> 11     super().__init__(name=name)
     12     self.color=color
     13     print("Shark initialization successful!")

Cell In[149], line 4, in fish.__init__(self, name)
      3 def __init__(self, name):
----> 4     super().__init__(name=name)
      5     print("Fish initialization successful!")

File ~/Desktop/treeline_wt/1588-yieldmodeling-integration/device-predictions/.venv/lib/python3.9/site-packages/pydantic/main.py:341, in pydantic.main.BaseModel.__init__()

ValidationError: 1 validation error for shark
color
  field required (type=value_error.missing)

错误原因核心 #

问题出在Pydantic的BaseModel.__init__工作逻辑：

• 实例化shark时，会依次调用shark.__init__、fish.__init__，最终触发BaseModel.__init__
• BaseModel.__init__是根据当前实例的实际类（也就是shark）做字段验证的，它会检查shark的所有必填字段——包括继承自fish的name和自身定义的color
• 你在fish.__init__里只传了name给BaseModel.__init__，此时shark的color字段缺失，直接触发验证错误，后续手动给self.color赋值的代码根本没机会执行

同事方案的原理 #

同事用**kwargs传递参数的写法能生效，本质是让所有字段参数都能到达BaseModel.__init__：

• 父类和子类的__init__都用**kwargs接收所有传入的参数（包括name和color）
• 调用super().__init__(**kwargs)时，会把所有参数原封不动传给BaseModel.__init__，这样BaseModel能拿到shark需要的所有字段，完成验证和赋值
• 这里父类并没有“知晓”子类的属性，只是做了参数透传，真正处理字段验证的是BaseModel，它会根据实例的实际类（shark）识别需要验证的字段

更符合Pydantic设计的写法 #

Pydantic提供了专门的model_post_init方法，用来添加初始化后的额外操作，不需要重写__init__，能避免破坏Pydantic的初始化流程：

from pydantic import BaseModel

class fish(BaseModel):
    name: str
    
    def model_post_init(self, __context) -> None:
        print("Fish initialization successful!")

class shark(fish):
    color: str
    
    def model_post_init(self, __context) -> None:
        super().model_post_init(__context)
        print("Shark initialization successful!")

# 正常实例化，自动完成字段验证+额外操作
s = shark(name="bruce", color="grey")

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