Hiddify-Manager 项目中 JSON 序列化错误的解决方案

问题现象分析

在 Hiddify-Manager 项目版本 10.50.4 中，管理员尝试手动更新用户使用量时，系统抛出了一个 JSON 序列化错误。错误信息明确指出："Object of type datetime is not JSON serializable"，即系统无法将 datetime 类型的对象转换为 JSON 格式。

错误根源探究

从堆栈跟踪中可以清晰地看到，错误发生在 Actions.py 文件的第 185 行，当系统尝试使用 json.dumps() 函数序列化使用量数据时失败。这通常意味着返回的数据结构中包含了 Python 的 datetime 对象，而 JSON 标准格式并不直接支持这种数据类型。

技术背景说明

JSON (JavaScript Object Notation) 是一种轻量级的数据交换格式，它仅支持以下几种基本数据类型：

• 字符串
• 数字
• 布尔值
• 数组
• 对象（字典）
• null

Python 的 datetime 对象不属于上述任何一类，因此直接序列化会失败。这是 Python Web 开发中常见的一个问题。

解决方案建议

针对这个问题，有以下几种可行的解决方案：

1. 数据类型转换：在序列化前，将 datetime 对象转换为字符串格式。Python 的 datetime 对象有 isoformat() 方法可以方便地实现这一点。

2. 自定义 JSON 编码器：创建一个继承自 json.JSONEncoder 的子类，重写 default 方法，在其中处理 datetime 对象的序列化。

3. 使用第三方库：可以考虑使用如 marshmallow 这样的库，它提供了更强大的序列化功能，能够自动处理各种复杂数据类型。

4. 数据预处理：在查询数据库时，直接获取格式化后的字符串而非 datetime 对象。

实施建议

对于 Hiddify-Manager 项目，最直接的修复方式是在 update_local_usage() 方法返回数据前，确保所有 datetime 对象都已转换为字符串。例如：

import json
from datetime import datetime

def datetime_handler(x):
    if isinstance(x, datetime):
        return x.isoformat()
    raise TypeError("Unknown type")

json.dumps(data, default=datetime_handler)

预防措施

为了避免类似问题再次发生，建议：

1. 在代码审查时特别注意涉及 JSON 序列化的部分
2. 为相关功能添加单元测试，确保各种数据类型都能正确序列化
3. 在项目文档中明确标注哪些API会返回包含日期时间的数据

总结

这个错误虽然看似简单，但反映了在Web开发中数据类型处理的重要性。正确处理各种数据类型的序列化不仅能避免运行时错误，还能提高系统的健壮性和可维护性。对于Hiddify-Manager这样的网络管理工具，确保数据能够正确传输和显示尤为重要。