本文深入解析了 Python 中 `json.dumps()` 如何安全、灵活地序列化 `set` 和 `frozenset` 这两类 JSON 原生不支持的数据结构，从最轻量的 `default` 回调函数方案（如直接转为有序或无序列表），到保留集合语义的自定义 `JSONEncoder` 类实现（通过添加元信息标识类型），再到应对嵌套集合、不可序列化元素及无限循环等易被忽视的实战陷阱，全面覆盖性能、可读性、兼容性与健壮性考量——无论你是想快速解决报错，还是构建可维护的跨系统数据协议，这里都有直击痛点的实用策略和关键避坑指南。

json.dumps() 默认不支持 set / frozenset

直接传 set 或 frozenset 给 json.dumps() 会报 TypeError: Object of type set is not JSON serializable。JSON 标准本身没有对应集合的类型，Python 的 json 模块默认只认 dict、list、str、int、float、bool 和 None。

用 default 参数把 set 转成 list

最常用、最轻量的做法是通过 default 参数提供一个回调函数，对不认识的类型做转换：

import json
def json_default(obj):
if isinstance(obj, (set, frozenset)):
return list(obj)
raise TypeError(f"Object of type {type(obj).name} is not JSON serializable")
data = {"tags": {"python", "web", "api"}, "readonly": frozenset([1, 2, 3])}
json_str = json.dumps(data, default=json_default, sort_keys=True)
→ {"readonly": [1, 2, 3], "tags": ["api", "python", "web"]}

• default 函数只在遇到无法序列化的对象时被调用，不影响其他类型
• 返回 list(obj) 是安全的，但注意：set 无序，转成 list 后顺序不保证（如需稳定顺序，可加 sorted()）
• 不要在 default 中返回原始 obj 或递归调用 json.dumps()，否则会无限循环

需要保持集合语义？考虑自定义 encoder 类

如果下游解析器能配合改造，想显式区分“这是个集合”，可以继承 json.JSONEncoder 并重写 encode 或 default：

class SetEncoder(json.JSONEncoder):
    def default(self, obj):
        if isinstance(obj, set):
            return {"__set__": True, "values": list(obj)}
        if isinstance(obj, frozenset):
            return {"__frozenset__": True, "values": list(obj)}
        return super().default(obj)
json.dumps({"s": {1, 2}}, cls=SetEncoder)
→ {"s": {"set": true, "values": [1, 2]}}

• 这种格式增加了元信息，但要求解析端也识别 __set__ 字段并还原
• 不能和 default 参数混用（cls 优先级更高）
• 若数据里还有其他自定义类型，记得在 default 末尾调用 super().default(obj)，否则会丢弃默认行为

注意嵌套结构和不可哈希元素

set 里如果包含不可 JSON 序列化的对象（比如另一个 set、函数、或自定义类实例），仅靠上面的 default 还不够：

• {1, {2, 3}} 会失败，因为内层 set 在外层 list(obj) 时才触发序列化，但此时已脱离 default 控制范围
• 正确做法是确保 default 能递归处理——但 json.dumps() 不提供递归钩子，所以得手动扁平化或预处理
• 更稳妥的方式是：在调用 json.dumps() 前，用递归函数把所有 set/frozenset 替换为 list，再 dump

真正容易被忽略的是：你以为只改了顶层 set 就万事大吉，结果数据嵌套三层后某个字典的值仍是未处理的 frozenset，错误才冒出来。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《在Python中，json.dumps()默认不支持直接序列化set或frozenset类型。要自定义序列化这些类型，可以通过以下方式实现：✅方法一：使用default参数（适用于Python3.4+）你可以通过自定义一个函数，并将其作为default参数传给json.dumps()，来处理无法序列化的对象。importjsondefdefault_serializer(obj):ifisinstance(obj,set):returnlist(obj)elifisinstance(obj,frozenset):returnlist(obj)raiseTypeError(f"Objectoftype{type(obj)}isnotJSONserializable")data={"my_set":{1,2,3},"my_frozenset":frozenset([4,5,6])}json_str=json.dumps(data,default=default_serializer)print(json_str)输出：{"my_set":[1,2,3],"my_frozenset":[4,5,6]}✅方法二：使用Encoder子类（更灵活）如果你需要更复杂的逻辑，可以继承json.JSONEncoder并重写default方法。importjsonclassCustomEncoder(json.JSONEncoder):defdefault(self,obj):ifisinstance(obj》文章吧，也可关注golang学习网公众号了解相关技术文章。