解决Python中xx is not JSON serializable错误:自定义JSONEncoder详解

闻溪
闻溪
发布时间:2026-10-10 | 3人浏览过
原创

在使用Python处理JSON数据时,常遇到“xx is not JSON serializable”错误。这通常是因为字典中包含datetime、自定义类等标准JSON无法直接识别的类型。本文介绍如何通过自定义json.JSONEncoder子类来解决此问题,并提供具体代码示例。

错误原因分析

Python内置的json.dumps()方法在尝试将字典序列化为JSON字符串时,仅支持标准类型(如字符串、数字、列表、字典、布尔值和None)。当字典中包含datetime对象或自定义类实例时,标准编码器无法处理,从而抛出TypeError。

from datetime import datetimeimport jsonjson_1 = {'num':1112, 'date':datetime.now()}# 尝试直接序列化会报错# json.dumps(json_1)

执行上述代码将导致类似以下的错误信息:
TypeError: datetime.datetime(...) is not JSON serializable

解决方案:自定义JSONEncoder

要解决此问题,需要继承json.JSONEncoder类并重写default()方法。该方法会在遇到无法序列化的对象时被调用,允许我们定义如何将其转换为标准类型。

1. 处理datetime对象

以下示例展示了如何创建一个DateEncoder类,将datetime对象转换为字符串格式:

from datetime import datetimeimport jsonclass DateEncoder(json.JSONEncoder):  def default(self, obj):    if isinstance(obj, datetime):      return obj.__str__()    return json.JSONEncoder.default(self, obj)json_1 = {'num':1112, 'date':datetime.now()}print json.dumps(json_1, cls=DateEncoder)

输出结果示例:
{"date": "2014-03-16 13:56:39.003000", "num": 1112}

2. 处理自定义类对象

对于自定义类,同样可以通过继承JSONEncoder来实现序列化。以下示例演示了如何序列化一个包含User对象的字典:

# 定义自定义类class User(object):  def __init__(self, name):    self.name = name# 定义自定义编码器class UserEncoder(json.JSONEncoder):  def default(self, obj):    if isinstance(obj, User):      return obj.name    return json.JSONEncoder.default(self, obj)json_2 = {'user':User('orangle')}print json.dumps(json_2, cls=UserEncoder)

输出结果示例:
{"user": "orangle"}

总结

通过继承json.JSONEncoder并重写default()方法,可以灵活处理各种非标准类型的序列化问题。在使用时,只需在dumps()函数中指定cls参数为自定义的编码器类即可。这种方法不仅适用于datetime和自定义类,还可扩展到其他需要特殊处理的对象类型。

以上就是Python中解决“xx is not JSON serializable”错误的详细内容,更多关于Python JSON序列化的资料请关注本站其它相关文章!

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表