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

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

在使用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 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。