Python json解析金额 JSON 保留 Decimal的实现方法

订单接口把金额写成 19.90 时，如果先让 Python 按默认规则解析成 float，后面的计算和格式化就可能带上二进制浮点的误差。处理这类 JSON，关键不是解析后再把 float 包一层，而是在 json.loads() 阶段把 decimal.Decimal 作为 parse_float 回调传进去，让字面量直接进入十进制对象。

步骤一：先看默认 float 为什么不适合金额

Python 标准库 json 默认把 JSON 的 real number 解析为 float。浮点数适合测量值和一般计算，但金额常需要保留十进制字面量的精度与尾随零。Decimal 以十进制模型工作，能把 JSON 文本中的 19.90 按十进制意义保存下来。

这里的范围要先划清：parse_float 只处理带小数点或指数形式的 JSON 数字。像 100 这样的整数仍然走默认的 int，不会因为传了 parse_float 就自动变成 Decimal。

步骤二：把 Decimal 直接交给 parse_float

最小写法就是把 Decimal 本身作为回调。文档所说的“回调接收字符串”很重要：Decimal 收到的是 JSON 中的文本 "19.90"，不是已经被 float 污染过的二进制结果。

import json
from decimal import Decimal

payload = '{"order_id": 1001, "subtotal": 19.90, "discount": 0.10}'

# 让 JSON 小数字面量直接构造 Decimal，避免先经过 float。
order = json.loads(payload, parse_float=Decimal)

# parse_float 不接管整数；order_id 仍是 int。
subtotal = order["subtotal"]
discount = order["discount"]
payable = subtotal - discount

print(type(subtotal).__name__)  # Decimal
print(order["order_id"].__class__.__name__)  # int
print(payable)  # 19.80

这个例子里，Decimal("19.90") 和 Decimal("0.10") 都保留了输入的有效位信息，减法结果也能显示为 19.80。如果金额来自外部接口，建议把这一层解析逻辑放在输入边界，不要让业务代码到处猜字段类型。

步骤三：嵌套字段和异常输入仍按 JSON 规则处理

parse_float 不是只对顶层键生效。数组、嵌套字典和列表里的每个 JSON 小数都会调用同一个回调。它也不负责字段校验：缺少 amount、金额为字符串、或者业务上不允许负数，都应该交给后续的领域校验。

import json
from decimal import Decimal

payload = '{"items": [{"sku": "A-1", "amount": 2.50}, {"sku": "B-2", "amount": 7.25}], "tax": 0.55}'

# 解析回调只负责数值类型，不把商品字段规则塞进 json.loads()。
data = json.loads(payload, parse_float=Decimal)
total = sum((item["amount"] for item in data["items"]), Decimal("0"))
grand_total = total + data["tax"]

# 在业务层做范围判断，避免把负数默认为解析错误。
if grand_total 

非法 JSON 仍会触发 json.JSONDecodeError；合法 JSON 中的字符串金额则不会自动转成 Decimal。如果上游把金额写成 "19.90"，需要在字段校验层明确调用 Decimal(text)，并决定空字符串、货币符号和小数位规则。

步骤四：计算保留 Decimal，输出时再选择编码方案

解析成 Decimal 只解决输入和计算阶段，不能直接保证 json.dumps() 能编码它。标准 JSON 编码器通常不认识 Decimal，所以输出前要明确协议：对外接口常把金额编码成字符串，或者使用项目统一的自定义 JSONEncoder。不要在最后一刻随手调用 float(value)，否则又把精度边界交还给二进制浮点。

import json
from decimal import Decimal

result = {"amount": Decimal("19.80")}

class DecimalEncoder(json.JSONEncoder):
    # 用字符串表达金额，避免输出阶段重新变成 float。
    def default(self, obj):
        if isinstance(obj, Decimal):
            return format(obj, "f")
        return super().default(obj)

encoded = json.dumps(result, cls=DecimalEncoder)
print(encoded)  # {"amount": "19.80"}

如果对方协议明确要求 JSON number，而不是字符串，应在接口契约中写清小数位、舍入模式和接收方实现；这不是 parse_float 能替你决定的事。金额精度的完整链路是“文本解析为 Decimal、Decimal 参与运算、按协议编码输出”，三段都保持一致才稳妥。

常见问题

传了 parse_float=Decimal，整数金额会变成 Decimal 吗？

不会。它只接管 JSON 浮点字面量；整数仍由 parse_int 负责。若业务要求所有金额同一类型，需要另行设计整数回调或统一的字段转换规则。

为什么不能先 json.loads() 再 Decimal(value)？

因为这时 value 可能已经是 float。在解析入口直接接收字面量字符串，才能避免先经过二进制浮点表示。

Decimal 解析后能直接 json.dumps() 吗？

通常不能直接编码。应按接口协议将金额转为字符串，或提供自定义编码器；不要为了省事无条件转成 float。