PyMongo默认不支持decimal.Decimal因BSON无原生decimal类型,需用bson.decimal128.Decimal128转换后存取,以保障精度、查询、聚合及索引功能正常。

PyMongo 默认不支持 Python 的 decimal.Decimal
因为 BSON 协议(MongoDB 底层序列化格式)没有原生的 decimal 类型,PyMongo 的默认编码器只认 int、float、str、bool、datetime 等少数 Python 原生类型。decimal.Decimal 虽然是标准库类型,但被当作“自定义对象”拒绝序列化,直接抛出 TypeError: Type 或类似错误。
别用 json.dumps(..., default=str) 临时绕过
这种写法会让所有 Decimal('19.99') 变成字符串 "19.99",后果很实际:
- 字段类型丢失:MongoDB 里存的是字符串,无法做数值范围查询(
{"price": {"$gt": 15}}失效) - 索引失效:对字符串字段建的数值索引没意义,聚合计算(
$sum、$avg)会报错或返回空 - 读取后还要手动转回
Decimal,增加业务层负担且易漏
正确做法:用 decimal128 替代 decimal.Decimal
MongoDB 3.4+ 原生支持 Decimal128 类型,PyMongo 提供了对应封装。关键不是“怎么塞进去”,而是“用对类型”:
- 写入前,把
decimal.Decimal转成bson.decimal128.Decimal128:from bson.decimal128 import Decimal128doc = {"price": Decimal128("19.99")} - 读取时,驱动自动还原为
Decimal128对象,调用.to_decimal()得到原生decimal.Decimal - 注意:字符串字面量传入(如
"19.99")比 float 更安全,避免浮点精度污染原始值
批量插入时字段混杂,怎么统一处理?
如果 DataFrame 或 dict 列表里既有 int、float,又有 decimal.Decimal,不能全局 astype(str) —— 那会毁掉所有数值语义。稳妥方式是逐字段判断:
- 检查值是否为
decimal.Decimal实例,是则包装为Decimal128 - 其他数值类型(
int、float)保持原样,BSON 原生支持 - 避免对整个结构递归
default=lambda x: ...,容易误伤嵌套的合法类型(如datetime)
真正麻烦的从来不是“能不能写进去”,而是写进去之后——查得准不准、算得对不对、别人读得懂不懂。Decimal128 是唯一既保精度又保语义的路径,绕开它迟早要补回来。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











