### 解决方案 在 Python 中遇到 `TypeError: Object of type timedelta is not JSON serializable` 的原因是标准库中的 `json.dumps()` 方法无法直接处理 `timedelta` 对象[^3]。为了使 `timedelta` 能够被序列化为 JSON 格式，可以自定义一个函数来转换这些不可序列化的对象。 以下是实现方法： #### 自定义序列化器 通过传递参数 `default` 给 `json.dumps()` 函数，指定一个默认的序列化逻辑。该逻辑会捕获任何无法正常序列化的对象并将其转换成可序列化的形式（如字符串）。对于 `timedelta` 类型的数据，可以通过调用其 `.total_seconds()` 或者其他属性来进行转换。 ```python import json from datetime import timedelta def custom_serializer(obj): if isinstance(obj, timedelta): # 判断是否为 timedelta 类型 return str(obj) # 将 timedelta 转换为字符串表示 raise TypeError(f"Type {type(obj)} not serializable") # 如果不是 timedelta，则抛出异常 data = { 'duration': timedelta(hours=2, minutes=30), 'name': 'Example' } serialized_data = json.dumps(data, default=custom_serializer) print(serialized_data) ``` 上述代码中，当尝试序列化 `timedelta` 数据时，它会被自动转换为其字符串表示形式。 另一种方式是将 `timedelta` 转换成秒数或其他数值单位以便于存储和传输： ```python def custom_serializer(obj): if isinstance(obj, timedelta): return obj.total_seconds() # 返回总秒数作为浮点数 raise TypeError(f"Type {type(obj)} not serializable") data = {'time_diff': timedelta(days=1)} serialized_data = json.dumps(data, default=custom_serializer) print(serialized_data) # 输出 {"time_diff": 86400.0} ``` 这种方法更加灵活，允许接收端重新构建原始的时间间隔信息[^2]。 #### 使用内置选项简化操作 如果不想编写复杂的序列化逻辑，可以直接利用 `default=str` 参数让所有未识别的对象都转成它们各自的字符串版本： ```python data = {'delta': timedelta(seconds=90)} result = json.dumps(data, default=str) print(result) # 输出 '{"delta": "0:01:30"}' ``` 这种方式简单快捷，但可能会损失部分精度或语义信息。 --- ### 总结 针对 `TypeError: Object of type timedelta is not JSON serializable` 错误，推荐采用自定义序列化器的方式解决问题，并根据实际需求决定是以字符串还是具体数值的形式保存时间差值数据。