json.dumps() 默认不支持 datetime 等类型,需通过 default 参数或自定义 JSONEncoder 子类实现序列化,推荐转为 ISO 8601 字符串;时区需显式处理,反序列化需业务层自行解析。

json.dumps() 直接序列化 datetime 会报错
Python 原生 json.dumps() 不认识 datetime、date、time 这类对象,直接传入会抛出 TypeError: Object of type datetime is not JSON serializable。这不是配置问题,是标准库的硬性限制。
常见错误写法:
import json
from datetime import datetime
data = {"created": datetime.now()}
json.dumps(data) # ❌ 报错
用 default 参数自定义序列化逻辑
最常用也最可控的方式是给 json.dumps() 传 default 参数,它会在遇到无法序列化的对象时被调用。你需要自己判断类型并转成 JSON 支持的格式(通常是字符串)。
- 推荐统一转为 ISO 8601 字符串(带时区信息更安全)
- 如果对象可能含
datetime、date、time,都应在default函数中覆盖 - 不要在
default中无条件调用str(obj)—— 它输出的格式不标准,且不可逆
示例:
import json
from datetime import datetime, date, time
<p>def json_serializer(obj):
if isinstance(obj, datetime):
return obj.isoformat()
elif isinstance(obj, date):
return obj.isoformat()
elif isinstance(obj, time):
return obj.isoformat()
raise TypeError(f"Object of type {type(obj).<strong>name</strong>} is not JSON serializable")</p><p>data = {"created": datetime(2024, 5, 20, 14, 30, 45, 123456)}
json.dumps(data, default=json_serializer) # ✅ 输出: {"created": "2024-05-20T14:30:45.123456"}</p>
用 cls 参数配合 JSONEncoder 子类(适合项目级复用)
如果多个地方都要序列化时间对象,封装一个继承 json.JSONEncoder 的类比反复写 default 更清晰,也便于统一处理时区、精度或字段名规则。
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
- 子类重写
default()方法,逻辑和上一种方式一致 - 使用时传
cls=YourEncoder,而非default=... - 注意:不能同时传
default和cls,后者优先级更高
示例:
class DateTimeEncoder(json.JSONEncoder):
def default(self, obj):
if isinstance(obj, (datetime, date, time)):
return obj.isoformat()
return super().default(obj)
<p>json.dumps(data, cls=DateTimeEncoder)</p>
时区处理和精度丢失风险
datetime.isoformat() 默认不带时区(tzinfo=None 时),但很多业务需要明确时区上下文。若原始 datetime 是带时区的(如 datetime.now(timezone.utc)),isoformat() 会自动包含 Z 或 +08:00;但若你手动构造了 naive datetime,后续反序列化就无法还原时区含义。
- 建议所有 datetime 对象都显式带时区(用
pytz或zoneinfo) -
isoformat()默认保留微秒,但某些系统(如旧版 MySQL JSON 字段)只支持毫秒,必要时可截断:obj.strftime("%Y-%m-%dT%H:%M:%S.%f")[:-3] - 别依赖
json.loads()自动还原成 datetime —— JSON 标准里没有 datetime 类型,反序列化后永远是字符串,需业务层另行解析
真正容易被忽略的点是:序列化只是单向转换。你得自己决定「什么时候、由谁、用什么规则」把字符串再变回 datetime —— json 模块本身不负责这个。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










