答案是需通过default参数或自定义jsonencoder显式定义非标类型的序列化规则。json标准仅支持dict、list、str、int、float、bool和none；datetime、set、自定义类等须转为上述类型，推荐优先用default函数按类型逐个处理，避免万能转换或依赖__dict__引发嵌套错误。
json.dumps() 报错 TypeError: Object of type XXX is not JSON serializable
这是最典型的症状，说明 json.dumps() 遇到了它不认识的类型（比如自定义 class 实例、datetime、set 等）。JSON 标准只支持 dict、list、str、int、float、bool 和 None，其他都得手动转成这六种之一。
解决思路不是“绕过错误”，而是明确告诉 json.dumps()：这个对象该怎么变成字典或基本类型。
- 最常用的是传入
default参数，它是个函数，接收无法序列化的对象，返回能被序列化的等价物 - 不要试图重载
__dict__或直接返回self.__dict__—— 如果对象里有嵌套不可序列化字段（如datetime），还是会崩 - 避免用
vars(obj)替代obj.__dict__，行为几乎一样，没解决根本问题
如何写一个安全的 default 函数处理常见非标类型
别写万能转换器，先聚焦你实际用到的类型。比如你有 User 类和 datetime 字段：
def json_default(obj):
if isinstance(obj, datetime.datetime):
return obj.isoformat()
elif isinstance(obj, datetime.date):
return obj.isoformat()
elif isinstance(obj, set):
return list(obj)
elif hasattr(obj, '__dict__'):
# 仅当 obj 所有属性都可序列化时才退到 __dict__
return {k: v for k, v in obj.__dict__.items()
if not callable(v) and not k.startswith('_')}
raise TypeError(f"Object of type {type(obj).__name__} is not JSON serializable")
调用时：json.dumps(data, default=json_default)。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 顺序很重要：先判断具体类型（
datetime、set），再兜底处理类实例 - 兜底逻辑里要过滤掉方法、私有属性（以
_开头）和不可序列化值，否则仍可能抛错 - 别在
default里做复杂逻辑或递归调用json.dumps，容易栈溢出
为什么重写 __repr__ 或 __str__ 没用
json.dumps() 完全不看 __repr__ 或 __str__，它只认 default 回调或内置类型映射。你改了字符串表示，错误照报。
- 有人试过
return str(obj)在default里 —— 这只是把对象变字符串，丢失结构，后续反序列化无法还原 - 如果目标是调试输出，用
pprint.pprint()或vars(obj)更合适，别混进 JSON 流程 - 真正需要持久化/传输时，必须显式定义数据契约（即哪些字段导出、怎么格式化）
用 dataclass + asdict() 是更干净的替代方案吗
如果你控制得了类定义，dataclass 配合 dataclasses.asdict() 确实比手写 default 更稳，但要注意边界：
@dataclass
class User:
name: str
joined_at: datetime.datetime # asdict() 依然会原样保留 datetime，还是会报错
所以还得配合 default 或预处理字段：
-
asdict()只展开一层，不会递归处理嵌套对象里的非标类型 - 字段类型要是纯数据类型（
str、int等），或者你自己保证它已转成可序列化形式 - 如果类里有
Optional或Union类型，且值为None，asdict()会保留None，没问题；但若值是自定义对象，照样卡住
真正省事的点在于结构扁平、字段明确，而不是自动解决序列化问题。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
