Python dataclass 继承后报 non-default argument follows default argument

父类 dataclass 增加一个有默认值的字段后，子类还没创建实例，类定义就报 TypeError: non-default argument ... follows default argument。把子类必填字段挪到类体最上面，往往仍然报错。

这是生成构造函数时的参数顺序冲突。本文给出 Python 3.10 及以上可用的 keyword-only 处理方式；Python 3.7 至 3.9 的标准库 dataclass 没有 kw_only 参数，不能直接复制这项配置。

合并后的字段顺序才决定是否冲突

例如：

from dataclasses import dataclass

@dataclass
class Base:
    name: str
    retries: int = 3

@dataclass
class Job(Base):
    target: str

dataclass 会先收集基类字段，再加入当前类字段。多重继承时，基类按反向 MRO 收集，不能只按某一个类体里的视觉顺序判断。这里生成普通参数所需的顺序是 name、有默认值的 retries、无默认值的 target，违反了普通参数的默认值顺序要求。

在 traceback 指向的类及其基类里，列出参与初始化的字段，并标明哪些有默认值、哪些为 keyword-only。给继承来的同名字段重新赋默认值，也不等于把它移动到最后。只改实例化语句为关键字传参，无法修复类定义阶段已经发生的错误。

只把新增必填字段改为 keyword-only

如果要保留父类的调用形式，可以只调整子类字段：

from dataclasses import dataclass, field

@dataclass
class Base:
    name: str
    retries: int = 3

@dataclass
class Job(Base):
    target: str = field(kw_only=True)

job = Job("daily", target="archive")
print(job.name, job.retries, job.target)

field(kw_only=True) 没有给 target 添加默认值，它仍然必填。生成的构造函数相当于 Job(name, retries=3, *, target)：普通参数之后的 keyword-only 参数允许保持必填。

同样可以在子类使用 @dataclass(kw_only=True)，让该类定义的字段采用关键字传参。不要把它理解成会自动重写所有继承字段的调用规则；已有基类字段及子类对同名字段的覆盖，仍需逐项检查。

全部改为关键字传参会改变调用接口

如果这个数据模型本来就适合全用字段名初始化，可以在相关类上统一配置：

from dataclasses import dataclass

@dataclass(kw_only=True)
class Base:
    name: str
    retries: int = 3

@dataclass(kw_only=True)
class Job(Base):
    target: str

job = Job(name="daily", target="archive", retries=5)

示例中的参数顺序冲突可以这样解决，但原来类似 Base("daily") 的位置参数调用也需要迁移。检查工厂函数、测试数据、反序列化适配器和外部调用方，不能只修改类定义。

keyword-only 字段还不会加入自动生成的 __match_args__。若项目用位置模式匹配解构 dataclass，也要核对相应代码；按字段名初始化和按位置匹配并不是同一项兼容性检查。

旧版本要保留必填语义

Python 3.7 至 3.9 中，可以调整模型，让普通必填字段在默认字段之前；涉及继承时，可能需要拆分职责、采用组合，或明确编写构造函数。这些属于接口设计改动，应根据实际类层次选择，不能靠在子类中换行排序保证成功。

给所有必填字段都加 None，确实可能绕过这一项顺序检查，却也允许调用方省略原本必填的数据。若业务并不接受缺失值，这不是等价修复。使用手写构造函数时还要负责初始化所有必要字段，不能继续假设 dataclass 会自动生成那部分初始化逻辑。

验证构造签名和既有调用

修改后的类可以用以下方式查看接口：

from inspect import signature

print(signature(Job))

使用第一种修复时，应能看到 target 位于 * 后且没有默认值。随后检查三种调用：只传必填字段、显式覆盖默认值、故意漏掉必填字段。最后一种仍应被拒绝。还应检查现有位置参数调用是否保留了原来的字段含义。

将类定义、调用点和模式匹配相关改动放在同一次可回退的修改中。若外部调用方尚未迁移，优先选择影响较小的单字段方案，或暂缓切换完整构造接口；不要在运行时捕获这个类定义错误并跳过加载模型。