json.dumps(obj)报错因只支持内置类型,自定义类需用default参数配转换函数或在类中实现__json__方法,避免直接用JSONEncoder子类。

为什么 json.dumps(obj) 直接报 TypeError: Object of type X is not JSON serializable
因为 Python 的 json 模块默认只认内置类型(dict、list、str、int、float、bool、None),遇到自定义类实例会直接抛错。它不会自动调用 __dict__,也不会识别你写的 to_dict() 方法。
最简可行方案:用 default 参数配一个转换函数
这是最轻量、侵入性最小的方式,适合临时序列化或结构较固定的类。
- 定义一个函数,接收任意对象,返回可序列化的等价物(如
dict),对不认识的类型抛回原错误 - 传给
json.dumps(..., default=your_func) - 注意:该函数会被递归调用,所以必须能处理嵌套对象(比如类里有另一个自定义类属性)
def to_serializable(obj):
if hasattr(obj, '__dict__'):
return obj.__dict__
elif isinstance(obj, (datetime.date, datetime.datetime)):
return obj.isoformat()
raise TypeError(f"Object of type {type(obj).__name__} is not JSON serializable")
json.dumps(my_instance, default=to_serializable)
更可控的做法:让类自己声明如何序列化(实现 __json__ 或统一接口)
Python 本身没有强制约定,但你可以约定一个方法名(比如 __json__ 或 to_json_dict),并在 default 函数中检查它。这样逻辑集中在类内部,避免外部函数越写越胖。
- 在类中定义
def __json__(self): return {"name": self.name, "id": self.id} -
default函数里加一句if hasattr(obj, '__json__'): return obj.__json__() - 比纯
__dict__更安全:可过滤敏感字段、处理不可序列化的属性(如数据库连接)、做类型预转换 - 注意:别在
__json__里返回自身或循环引用对象,否则json会栈溢出
别碰 JSONEncoder 子类,除非你真需要全局复用
继承 json.JSONEncoder 看似“正规”,但实际容易踩坑:
exa-js 是 Exa 官方 JavaScript 软件开发工具包,Exa 是一个为 AI 工作流构建的网络搜索 API。它为代理提供了一种具体的方式来搜索网络、检索页面内容,并从代码中生成有来源的答案,而不是手动拼接原始 HTTP 调用。
立即学习“Python免费学习笔记(深入)”;
- 必须重写
default(self, obj),逻辑和上面手动写的default函数几乎一样 - 一旦设为全局
cls=MyEncoder,所有json.dumps都走它,容易误伤第三方库返回的对象 - 无法按需启用——比如只想序列化 A 类,不想影响 B 类,就得每次传
cls=,反而更啰嗦 - 调试时难定位:错误堆栈里看不到你写的 encoder 逻辑在哪被触发
真正需要它的场景极少,比如你在写一个 SDK,要求所有用户输出都走同一套序列化规则,并且能保证输入类型可控。
最常被忽略的一点是:序列化不是单向操作。如果你靠 __dict__ 草率导出,反序列化时得手动构造实例,字段缺失、类型错位、嵌套对象还原失败这些问题,会在下游悄悄爆发。

















