Python dataclass多继承下特殊方法使用及__post_init__不生效问题求解

问题成因 #

Python的方法解析顺序（MRO）决定了多继承场景下同名方法只会调用继承链上第一个匹配到的实现，__post_init__属于普通实例方法，没有特殊的多继承适配逻辑。你定义的子类C的继承顺序是C(A, B)，所以dataclass自动生成的__init__方法执行完字段赋值后，只会调用A类的__post_init__，B类的__post_init__直接被覆盖不会触发，这就是B的b字段保持默认空字典的原因。

解决方案 #

方案1：在子类中显式调用所有父类的__post_init__ #

直接在C类里定义自己的__post_init__，逐个调用父类的对应方法，是最直观、兼容性最好的方案：

@dataclass
class C(A, B):
    def __post_init__(self):
        # 按继承顺序调用所有父类的__post_init__
        A.__post_init__(self)
        B.__post_init__(self)

修改后实例化C的输出就会变成C(b={'b1': 0, 'b2': 0}, a={'a1': 0, 'a2': 0})，符合预期。

方案2：父类中使用super()调用适配多继承 #

如果父类设计时就考虑到会被多继承，可以把__post_init__改写成链式调用的形式，不需要子类额外写逻辑：

@dataclass
class A:
    a: Dict[str, int] = field(default_factory=dict)

    def __post_init__(self):
        super().__post_init__()
        self.a = {'a1': 0, 'a2': 0}

@dataclass
class B:
    b: Dict[str, int] = field(default_factory=dict)

    def __post_init__(self):
        # 顶层父类的super调用增加判断避免异常
        if hasattr(super(), '__post_init__'):
            super().__post_init__()
        self.b = {'b1': 0, 'b2': 0}

@dataclass
class C(A, B):
    pass

这种方案的优势是后续新增继承自A、B的子类时，不需要重复写父类调用逻辑，更适合框架类代码的场景。

方案3：调整字段默认值替代__post_init__赋值 #

如果你的__post_init__逻辑只是给字段赋固定初始值，可以直接把默认值写在field的default_factory里，完全不需要用到__post_init__，从根源避免多继承冲突：

@dataclass
class A:
    a: Dict[str, int] = field(default_factory=lambda: {'a1': 0, 'a2': 0})

@dataclass
class B:
    b: Dict[str, int] = field(default_factory=lambda: {'b1': 0, 'b2': 0})

@dataclass
class C(A, B):
    pass

这种方案代码最简洁，没有额外的调用逻辑，适合初始化逻辑简单的场景。

内容的提问来源于stack exchange，提问作者Jeffery-the-newbie