python标准库json慢因纯python实现及默认启用unicode解码、对象钩子、重复键检查等安全逻辑;ujson和orjson用c/c++编写,跳过部分校验,速度快2–5倍。

为什么默认的 json 模块慢?
Python 标准库 json 是纯 Python 实现(C 扩展版虽快些,但仍有开销),且默认启用严格 Unicode 解码、对象钩子、重复键检查等安全/兼容性逻辑。当你解析大量小 JSON(如日志行、API 响应流)或高吞吐场景(如 Web 服务反序列化请求体),这些开销会明显拖慢速度。
关键瓶颈在:字符串解码、字典构建、类型校验。而 ujson 和 orjson 都用 C/C++ 编写,跳过部分校验,直接映射到 Python 对象,实测快 2–5 倍(取决于数据结构)。
ujson 和 orjson 的实际选型差异
两者都不是万能替代品,得看你的数据特征和运行环境:
-
ujson支持 Python 2.7+,兼容性好;但不支持datetime直接解析,遇到 ISO 格式时间字符串会原样返回str,需额外处理 -
orjson要求 Python 3.6+,仅支持 UTF-8 输入(不接受 bytes 里混编码),但原生支持datetime、dataclass、numpy类型,且默认返回bytes键的字典(注意:不是str键!) -
orjson.loads()不接受object_hook或parse_float等参数,扩展性弱;ujson则保留了部分json接口风格 - 若你用
uvloop+httpx异步栈,orjson因零拷贝设计,在内存受限时更稳;ujson在某些嵌套极深的 dict 场景下偶发栈溢出
异步上下文中怎么安全集成?
别直接在 async def 里调用 orjson.loads()——它仍是同步阻塞调用。CPU 密集型操作会卡住事件循环。正确做法是用 loop.run_in_executor 脱离主线程,或预判是否真需要异步:
- 如果 JSON 数据来自网络 I/O(比如
await response.aread()后得到bytes),先完成 I/O,再同步解析——此时解析本身不占大头,无需额外线程池 - 如果批量解析本地文件流或 Kafka 消息(每条几 KB,QPS > 1k),建议封装成 executor 任务:
import asyncio import orjson async def async_json_loads(data: bytes): loop = asyncio.get_running_loop() return await loop.run_in_executor(None, orjson.loads, data) - 避免对单次小数据( 512 字节)再走线程池
-
ujson同理,但注意它对bytes输入支持不稳定(某些版本只认str),务必先data.decode("utf-8")
容易被忽略的坑:编码、键类型与错误传播
换库不是改个 import 就完事。三个高频翻车点:
-
orjson只吃 UTF-8bytes,传str会报TypeError: expected bytes;传 GBK 编码的bytes会直接ValueError,且不提示具体编码问题 -
orjson.loads(b'{"key":1}')["key"]没问题,但orjson.loads(b'{"key":1}').keys()返回的是dict_keys([b'key'])—— 键是bytes,不是str,后续用dict.get("key")会返回None -
ujson遇到非法 JSON(如尾部逗号)抛ValueError,而标准json抛JSONDecodeError(继承自ValueError)。如果你有except json.JSONDecodeError:的旧逻辑,得改成捕获ValueError并检查消息内容,或统一包装一层
最稳妥的做法:在项目入口加一层适配器函数,屏蔽底层差异,同时强制做编码归一化和键类型转换——这点常被跳过,直到线上出现 KeyError: b'id' 才发现。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











