Python 3.11 输出接口数据时 datetime 报 TypeError 该换哪种序列化

报表导出接口跑在 Python 3.11 加 Flask 上,数据从 MySQL 取出来直接塞进 diCt,json.dumps 一调用就抛 TypeError: Object of type datetime is not JSON serializable。本地用 SQLite 测的时候字段是字符串,一直没暴露,换到线上 MySQL 的 DATETIME 才炸。

第一反应是给 dumps 加 default=str,接口立刻能返回了。前端把时间显示成 2026-11-12 08:00:00,比实际早了八小时。数据库里存的是东八区本地时间,str() 只做了格式化,没有带时区偏移,前端 new Date 按 UTC 解析,差的这八小时就这么来的。

试过在 SQL 里 DATE_FORMAT 成字符串,导出接口正常了,可同一个 dict 还被另一个接口复用,那边又要 datetime 做时间运算,改一处崩一处。也试过给每个字段手写 .isoformat(),二十多个字段铺一遍,漏一个就再报一次同样的错。

最后写了一个 JSONEncoder 子类,datetime 统一 astimezone 到 UTC 再 isoformat,Decimal 转 float 并保留两位小数。default 方法只在遇到不认识的类型时被调用,所以 datetime 的子类也会走到这里,不用单独判断。ensure_ascii 设成 False,中文报表名不会再变成一串转义。

顺带发现 Decimal 走 default=str 会返回 12.30 这种带引号的字符串,前端直接当字符串拼进金额计算,加出来变成 012.30。这种错在 default=str 的写法下完全不会报错,只是数字悄悄变成了文本。

确认口径:导出 2000 行报表,接口 200 且 JSON 能解析;逐行比对时间字段与数据库原始值,UTC 加八小时后完全一致;再抽查金额字段的 typeof,全部是 number。

class ApiEncoder(json.JSONEncoder):
    def default(self, obj):
        if isinstance(obj, datetime):
            return obj.astimezone(timezone.utc).isoformat()
        if isinstance(obj, Decimal):
            return float(obj)
        return super().default(obj)

您可以还会对下面的文章感兴趣: