Python中json格式化时遇到报错如何解决？

遇到JSON格式化报错，先别慌，大部分问题都出在数据格式上。Python的json模块要求序列化的对象必须是JSON兼容的，比如字典、列表、字符串、数字、布尔值和None。常见的坑主要有两个：

1. 对象包含非JSON兼容类型 比如datetime对象、自定义类实例、set集合等。处理方法是把它们转换成基本类型。

import json
from datetime import datetime

data = {
    'name': 'test',
    'time': datetime.now(),  # 直接放datetime会报错
    'numbers': {1, 2, 3}     # set也不行
}

# 解决方案：自定义序列化函数
def custom_serializer(obj):
    if isinstance(obj, datetime):
        return obj.isoformat()  # 转成字符串
    elif isinstance(obj, set):
        return list(obj)        # 转成列表
    raise TypeError(f"Object of type {type(obj)} is not JSON serializable")

# 使用default参数
json_str = json.dumps(data, default=custom_serializer)
print(json_str)  # 正常输出

2. 字符串编码问题 包含特殊字符或二进制数据时容易出错。确保字符串是有效的UTF-8。

# 处理特殊字符
data = {'text': '包含特殊字符\x00的字符串'}

# 方案1：忽略错误字符
json_str = json.dumps(data, ensure_ascii=False, errors='ignore')

# 方案2：手动清理
import re
cleaned_text = re.sub(r'[\x00-\x1f\x7f-\x9f]', '', data['text'])
data['text'] = cleaned_text
json_str = json.dumps(data, ensure_ascii=False)

快速排查步骤：

1. 先用print(type(your_data))看看整体结构
2. 递归检查数据中的每个元素是否都是基础类型
3. 如果数据复杂，考虑用json.dumps(data, default=str)先转成字符串看看哪里出错

总结建议：确保所有数据都是JSON兼容的基本类型。