使用dataclass_json解析含tuple字段的数据类时触发AttributeError

问题重现 #

定义包含tuple类型字段的dataclass并使用dataclass_json序列化/反序列化：

from dataclasses import dataclass
from dataclasses_json import dataclass_json

@dataclass_json
@dataclass
class ObjectData:
    position: tuple = (0, 0)

尝试从JSON解析时触发错误：

data = get_json_data()  # 返回JSON字符串
my_object = ObjectData.from_json(data)

报错信息：

AttributeError: type object 'tuple' has no attribute '__args__'. Did you mean: '__add__'?

即使先将JSON转成字典并手动解析tuple字符串，仍然触发相同错误。

报错原因 #

dataclass_json在处理泛型容器类型（如tuple、list）时，需要明确的参数化类型标注（即指定tuple内部元素的类型）。原始的tuple类型没有__args__属性（这是泛型类型的属性，用于存储类型参数），导致库在解码时无法识别如何处理该字段。

解决方法 #

根据你的tuple使用场景，选择对应的类型标注方式：

1. 固定长度+统一元素类型的tuple #

比如二维坐标(x, y)，使用参数化的tuple类型：

from dataclasses import dataclass
from dataclasses_json import dataclass_json
from typing import Tuple  # Python 3.9+可直接使用内置tuple[int, int]

@dataclass_json
@dataclass
class ObjectData:
    # 其他字段...
    position: Tuple[int, int] = (0, 0)

2. 混合类型或可变长度的tuple #

比如('top', 55)这种混合类型，或者长度不固定的tuple，可使用Union标注元素类型，或用...表示任意长度：

from dataclasses import dataclass
from dataclasses_json import dataclass_json
from typing import Tuple, Union

@dataclass_json
@dataclass
class ObjectData:
    # 混合类型固定长度
    position: Tuple[Union[str, int], Union[str, int]] = ('top', 55)
    # 或任意长度任意类型
    # position: Tuple[object, ...] = ('top', 55, 'left', 10)

3. 处理JSON中字符串形式的tuple #

如果你的JSON数据中position是字符串格式（如"(10,20)"），需要先将其转换为数组，再传给from_dict：

from ast import literal_eval
import json
from dataclasses import dataclass
from dataclasses_json import dataclass_json
from typing import Tuple

@dataclass_json
@dataclass
class ObjectData:
    position: Tuple[int, int] = (0, 0)

data = get_json_data()
data_dict = json.loads(data)
# 将字符串tuple转为列表（dataclass_json会自动转成tuple）
data_dict['position'] = list(literal_eval(data_dict['position']))
my_object = ObjectData.from_dict(data_dict)

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