Python dataclass继承报错：无默认值字段不可位于有默认值字段后

问题原因 #

这个报错是dataclass的核心规则决定的：@dataclass装饰器生成__init__方法时，会按照类继承的MRO顺序合并所有父类、当前类的字段，所有无默认值的位置参数必须排在带默认值的参数之前。你的父类TableMetadata最后一个字段columns已经带了默认值，子类RestTableMetadata新增的无默认值字段method按顺序会排在columns之后，直接违反参数顺序规则，因此触发Pylance检查报错。

关于__init_subclass__的可行性 #

不推荐用这个方法解决问题。
__init_subclass__的触发时机是子类创建完成、装饰器执行之前，而dataclass的字段收集、__init__生成逻辑完全是@dataclass装饰器内部处理的。如果要靠__init_subclass__绕开顺序限制，你需要手动修改类的__annotations__字段顺序、同步调整__dataclass_fields__的存储结构、手动匹配字段和默认值的对应关系，这些都是dataclass的内部实现细节，不同Python版本兼容性差，维护成本极高，完全没有必要。

无需重写__init__的可行解决方案 #

按照推荐优先级排序：

1. 用kw_only参数（Python 3.10+ 最优解） #

Python 3.10为dataclass新增了kw_only配置，只要给类加@dataclass(kw_only=True)，类下所有字段都会变成仅限关键字传参，不再受位置参数的顺序限制，从根源上解决这个问题。
你可以直接给基类加配置，所有子类自动适配：

from dataclasses import dataclass, field

@dataclass(kw_only=True)
class TableMetadata:
    """
    - entity: business entity represented by the table
    - origin: path / query / url from which data withdrawn
    - id: field to be used as ID (unique)
    - historicity: full, delta
    - upload: should the table be uploaded
    """
    entity: str
    origin: str
    view: str
    id: str = None
    historicity: str = "full"
    upload: bool = True
    columns: list = field(default_factory=list)


@dataclass
class RestTableMetadata(TableMetadata):
    """
    - method: HTTP method to be used
    - payloadpath: portion of the response payload to use to build the dataframe
    """
    method: str
    payloadpath: str = None

实例化时所有参数用关键字传入即可，比如RestTableMetadata(entity="user", origin="/api/user", view="v_user", method="GET")。元数据类本身字段较多，用关键字传参反而能避免参数顺序传错的问题，可读性更好。
如果你不想让基类所有字段都变成关键字参数，也可以只给子类加@dataclass(kw_only=True)，仅让子类新增的字段变成关键字参数，同样能解决顺序冲突。

2. 哨兵默认值+__post_init__校验（兼容Python 3.7+全版本） #

如果你的运行环境低于Python 3.10，没法用kw_only，可以给子类的必填字段加一个哨兵默认值绕开顺序检查，再通过dataclass自带的__post_init__钩子做必填校验，全程不需要重写__init__：

from dataclasses import dataclass, field

# 基类保持原有定义不变
@dataclass
class TableMetadata:
    entity: str
    origin: str
    view: str
    id: str = None
    historicity: str = "full"
    upload: bool = True
    columns: list = field(default_factory=list)


@dataclass
class RestTableMetadata(TableMetadata):
    method: str = None
    payloadpath: str = None

    def __post_init__(self):
        if self.method is None:
            raise ValueError("`method` is a required field for RestTableMetadata")

这个方案对原有代码侵入性极小，唯一的小问题是类型检查器会默认method可以传None，你可以通过类型标注# type: ignore[assignment]或者自定义哨兵值消除这个警告。

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