JSON Response 的序列化

jsonify 的输出

实测 · 本机执行输出

  GET /j     → application/json | '{"a":1,"b":2,"\\u4e2d\\u6587":"\\u503c"}\n'
  GET /list  → application/json | '[1,2,{"a":2,"z":1}]\n'
  GET /one   → application/json | '{"k":"v"}\n'
  GET /many  → application/json | '[1,2,3]\n'
  GET /none  → application/json | 'null\n'
  app.json 类型: DefaultJSONProvider | sort_keys = True | ensure_ascii = True | compact = None | mimetype = application/json

上一篇:Response 对象构造过程;下一篇:自定义 Response Class。大批量 JSON 与流式 JSON 见大批量 JSON 响应、Streaming JSON。

debug 与 compact

实测 · 本机执行输出

  app.debug=True: '{\n  "a": 1,\n  "b": 2,\n  "\\u4e2d\\u6587": "\\u503c"\n}\n'

各类型的序列化

实测 · 本机执行输出

  datetime       → "Fri, 02 Oct 2026 12:30:45 GMT"
  naive datetime → "Fri, 02 Oct 2026 12:30:45 GMT"
  date           → "Fri, 02 Oct 2026 00:00:00 GMT"
  time           → TypeError: Object of type time is not JSON serializable
  UUID           → "00000000-0000-0000-0000-0000000000ff"
  Decimal        → "1.10"
  dataclass      → {"x": 1, "y": "a"}
  __html__ 对象    → "<b>x</b>"
  Enum           → TypeError: Object of type Color is not JSON serializable
  set            → TypeError: Object of type set is not JSON serializable
  tuple          → [1, 2]
  bytes          → TypeError: Object of type bytes is not JSON serializable
  complex        → TypeError: Object of type complex is not JSON serializable
  普通对象           → TypeError: Object of type Plain is not JSON serializable
  float nan      → NaN
  float inf      → Infinity
  大整数            → 1180591620717411303424
  键是 int         → {"1": "a"}
  键是 tuple       → TypeError: keys must be str, int, float, bool or None, not tuple

自定义 provider

实测 · 本机执行输出

  自定义 provider: {"z":1,"a":[1,2,3],"raw":"ab","obj":{"a":1}}

return dict 与 jsonify

实测 · 本机执行输出

  return dict → {"a":2,"b":1} | jsonify → {"a":2,"b":1} | 完全相同: True

耗时

实测 · 本机执行输出

  app.json.dumps(sort_keys=True,默认)  0.793 ms;sort_keys=False  0.605 ms;标准库 json.dumps  0.594 ms;标准库紧凑分隔符 0.598 ms;输出长度 73540 字节

分步演示

JSON 序列化

本步的对象

本文用到的工具与边界

本机 macOS 27 arm64 / Python 3.14.7 / Flask 3.1.3 / Werkzeug 3.1.9 / Jinja2 3.1.6 / SQLAlchemy 2.1.1 / gunicorn 26.2.0(都装在自己的虚拟环境里);大多数实验用 Flask 的 test_client(直接调用 WSGI 应用,不经过网络),需要真实 HTTP 时另起 gunicorn 或开发服务器(端口 9600 以上,本机 127.0.0.1);计时用 time.perf_counter,数字每次运行会有小幅抖动
没有验证:orjson 等第三方库做 provider 的耗时差别(见第 164 篇)、datetime 以 ISO 8601 输出的配置方法、provider 的 loads 与请求解析的配合、Decimal 精度在前端的表现

下一篇 · FLASK 41

自定义 Response Class