把金额样例贴进格式化工具,末尾两个零没了;很大的整数变成带 e 的形式,原来的 -0 也显示成 0。这些变化容易被理解为“格式化只加缩进,所以数字一定原样保留”。实际操作要先看工具是否解析并重新输出了数值。

下面在JSON格式化工具中用四个公开样例做对照。本文关注数字的表示形式;订单号超过安全整数范围的情况,另见长整数精度核对,两种问题不要混在一起处理。

先保留没有处理的输入

用这一段替换编辑框内容,暂时不按按钮:

{"small":1e-7,"large":1e21,"price":1.2300,"negativeZero":-0}
点击格式化之前,原文保留1e21、1.2300和-0这些字面写法
点击格式化之前,原文保留1e21、1.2300和-0这些字面写法

第一张图记录的是输入状态。small 使用负指数,large 使用正指数,price 保留四位小数,最后一个数字是负零。这几种写法都值得在处理前留副本,否则只保存格式化结果,后面就难以核对原文到底怎样写。

JSON数字允许指数部分,也允许小数部分;它没有一个单独的“固定两位金额”数据类型。因此,1.2300 中的末尾零能作为原文字符被看到,却不意味着接收程序一定保留了“四位小数”这个展示要求。

点击按钮后,核对四处变化

点击“校验 / 格式化”,本次输出为:

{
  "small": 1e-7,
  "large": 1e+21,
  "price": 1.23,
  "negativeZero": 0
}
本次格式化把1e21写成1e+21、1.2300写成1.23、-0写成0
本次格式化把1e21写成1e+21、1.2300写成1.23、-0写成0

small 仍然是指数形式,没有被强行展开成七位小数;large 的指数中增加了加号;price 不再保留末尾两个零;negativeZero 的负号也没有出现在重新输出的JSON里。页面给出了成功提示,这说明本次语法处理通过,不能据此推导“原始数字文本逐字未变”。

按 JavaScript 数值解析和重新序列化这组输入,可以复现这些写法。JSON格式化后的字符串与输入不同,既包括空格换行,也包括数字字面量。需要逐字比较、原文归档或签名核对时,必须保留未经处理的那份文本。

这里不把 1e+21 与 1e21 的字符串不同写成数值精度丢失:两者表示同一个十进制数量。也不由这组样例保证所有数值都能准确往返,超出数值实现范围、超长有效数字等仍可能产生独立问题。

原始写法需要保留时,明确数据约定

如果接收方确实要求保留小数位数,可以在双方约定允许时,将展示文本单独作为字符串保存:

{"priceText":"1.2300","measurementText":"1e-7","amount":1.23}
字符串字段中的末尾零和指数写法保持原样,amount则仍为数值
字符串字段中的末尾零和指数写法保持原样,amount则仍为数值

这次 priceText 仍是 "1.2300",measurementText 仍是 "1e-7"。它们被双引号包围,类型已经与 amount 不同,不能只为了让屏幕看起来不变,就擅自把接口数值字段改成字符串。要先确认接收方能否接受,并明确哪个字段用于计算、哪个字段用于展示。

另一种常见设计是把金额按最小货币单位保存为整数,再由界面按货币规则显示。是否采用这种设计、整数范围有多大、怎样舍入,属于业务与接口约定,格式化工具不会替你选好。本次也没有把样例上传到支付接口验证。

比较结果时先确定比较对象

需要确认“值有没有变”,应按约定的数据类型、范围和精度比较;需要确认“原文有没有变”,则比较处理前后的原始字节。两种比较不能互相代替。

对签名、缓存键或审计归档尤其要留意:即使两个 JSON 文本被解析成相同数值,直接对原文字节计算的摘要也可能不同。反过来,接口页面显示同样的两位小数,也不能证明底层数字相同。联调时记录原始输入、工具输出和实际接收类型,就能明确差异发生在表示层还是数值层。