Python 开发7 分钟
Fastapi 最快的序列化返回-ORJSONResponse
这篇笔记聚焦 FastAPI 中使用 ORJSONResponse 提升 JSON 响应序列化性能的原因与配置方式，核心场景是接口返回大列表、大 JSON 或包含时间字段等复杂类型的数据库记录。正文将默认 JSONResponse/标准库 json 与 orjson 的路径拆开比较：前者通常先把 Python 对象转换成 Python str，再由 Web 层编码成 UTF-8 bytes；orjson 则直接生成可网络传输的 UTF-8 字节，减少一次全量内存拷贝和编码转换。文章还解释了 orjson 采用 Rust 实现、面向速度优化并利用 SIMD 的背景，以及它对 datetime、UUID、numpy、dataclasses 等类型的原生支持如何避免频繁回调 Python 函数，从而降低额外开销和 GIL 争用。实践部分给出安装 orjson、导入 ORJSONResponse，并通过 FastAPI(default_response_class=ORJSONResponse) 设置全局默认响应类的示例。性能判断上，文中认为纯序列化微基准可能达到标准库的 5 到 10 倍，但在真实 Web 接口里收益取决于响应体大小和瓶颈位置。对于只返回极小 JSON 的接口，网络 IO 可能掩盖差异；而返回几千行记录、数 MB JSON 或大量 datetime 字段时，ORJSONResponse 更可能带来可感知的响应时间下降。
fastapi