Python json.loads解析非标准数字的容错边界

处理外部 JSON 时，最容易误判的一点是：看到 NaN 就以为 json.loads() 一定会抛出异常。Python 标准库的默认解码器实际上会把 NaN、Infinity 和 -Infinity 读成浮点特殊值。这个行为适合兼容某些上游数据，但它们并不是严格 JSON 数字，直接进入接口、数据库或再次序列化都可能留下隐患。

Python json.loads为什么会接受 NaN 和 Infinity

Python 文档明确说明，JSONDecoder 默认理解这三个标记，并把它们映射到 float('nan')、正无穷和负无穷。这是 Python 为现实数据源保留的兼容行为，不代表这些字面量符合严格 JSON 规范。

import json

# 观察默认解码结果；输入来自外部时应先限制文本大小
payload = '{"score": NaN, "upper": Infinity, "lower": -Infinity}'
data = json.loads(payload)

print(type(data["score"]).__name__)  # float
print(data["score"] != data["score"])  # True：NaN 不等于自身
print(data["upper"] == float("inf"))  # True

这里的关键不是“能不能解析”，而是解析后的值还能不能安全地表达业务含义。NaN 的比较行为与普通数字不同，排序、聚合、数据库驱动和前端 JSON 互操作都可能出现额外分支。

用 parse_constant 把非标准数字拦在入口

如果接口契约要求严格 JSON，推荐在解析时传入 parse_constant。它只处理 -Infinity、Infinity 和 NaN，不会误伤正常整数、小数、null、true 或 false。

import json

def reject_nonstandard_number(token: str):
    # 保留原始标记，方便日志和上游修复定位
    raise ValueError(f"不接受非标准 JSON 数字: {token}")

raw = '{"score": NaN, "count": 3}'
try:
    data = json.loads(raw, parse_constant=reject_nonstandard_number)
except ValueError as exc:
    # 生产接口可在这里转成 400，并记录字段来源
    print(exc)

这个钩子比解析完成后再遍历字典更稳：嵌套数组和对象中的特殊值也会在解码阶段被拦截。若要把数字解析成 Decimal，那是 parse_float 的职责；它不能替代 parse_constant 对特殊标记做策略判断。

接口层归一化时要区分缺失值和无效值

有些历史接口已经把 NaN 当作“暂无结果”发送，此时可以把它归一化为 None，但要在边界层完成，并保留原始标记或字段日志。不要在核心业务对象里悄悄吞掉异常，否则“供应商给了坏数字”和“业务确实没有值”会变成同一种状态。

import json

def normalize_constant(token: str):
    # 兼容旧接口；新接口仍建议改为拒绝策略
    return None

raw = '{"temperature": NaN, "humidity": 0.62}'
data = json.loads(raw, parse_constant=normalize_constant)

# 进入业务层前做字段级判断，避免把 None 当作 0
if data["temperature"] is None:
    print("temperature 暂无有效读数")

归一化只解决输入兼容，不会自动让输出符合所有下游协议。若后续调用 json.dumps()，还应确认对象中没有重新出现 nan 或无穷值，并按接口约定决定使用 null、错误响应还是修正后的数字。

用检查表确定 json.loads 的处理策略

实际排查时先确认原始文本，再确认解析参数，最后检查下游序列化和存储约束。JSONDecodeError 只表示语法解析失败；如果默认模式成功返回了 float('nan')，说明问题已经进入数据语义层，不能只靠捕获这个异常解决。

常见问题

把 allow_nan=False 传给 json.loads 有效吗？

无效。allow_nan 属于序列化方向的 json.dumps()，反序列化入口应使用 parse_constant。

parse_constant 会处理 JSON 的 null 吗？

不会。null 会按正常 JSON 规则转成 None；钩子只接收三个非标准数字标记。

为什么不能统一把 NaN 改成 0？

零是有业务含义的真实数值，可能改变平均值、阈值和排序结果。若确实代表缺失，应使用明确的空值策略并记录来源。