开发实操 · 可复现示例
JSON 大整数精度丢失排查:19 位雪花 ID 为什么尾数变成 00?
复现 Java/Go 后端返回 64 位整型订单号在浏览器 JSON.parse 后尾数四舍五入的问题,给出前端定位方法与服务端字符串化方案。
由 DevTools 极客工具箱 维护 · 更新于
为什么接口里的 19 位数字在前端变了?
后端使用 MySQL BIGINT 或雪花算法(Snowflake ID)生成的 64 位整数通常有 18~19 位,而浏览器 JavaScript 的 Number 类型采用 IEEE 754 双精度浮点数,能精确表示的最大安全整数只有 Number.MAX_SAFE_INTEGER = 9007199254740991(16 位)。
一旦服务端在 JSON 里把它输出为数字而不是字符串:
{"orderId": 1859234567890123456}
浏览器执行 JSON.parse 后,末尾数字会被静默舍入,实际得到的对象值变成 1859234567890123500。如果前端再拿着这个“变了形”的 orderId 去请求详情或支付接口,就会出现“明明列表里有数据,点进去却 404 或查错单”的隐蔽故障。
如何用工具快速复现和排查
- 打开浏览器 DevTools 的 Network → Response 选项卡,直接查看未经过
JSON.parse的原始响应文本(不要看 Preview 面板,因为 Preview 已经按 JS 数值解析过了)。 - 复制原始文本到 JSON 格式化工具 进行格式化,同时对比原始数字与格式化后的尾数。
- 把原始响应和解析后的结果放到 文本差异比对工具 左右对照,能够一眼看出哪些字段的末两位被舍入成了
00或邻近偶数。
各语言服务端推荐修复方式
最稳妥的做法是在序列化阶段把超出 53 位安全整数的 ID 统一转为字符串输出:
Java(Jackson)
在实体类字段上标注字符串序列化器,或在全局 ObjectMapper 中将 Long 序列化为字符串:
import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;
public class OrderDTO {
@JsonSerialize(using = ToStringSerializer.class)
private Long orderId;
}
Go(encoding/json)
在结构体 tag 中显式加上 ,string:
type Order struct {
OrderID int64 `json:"orderId,string"`
}
序列化后会输出标准字符串 {"orderId":"1859234567890123456"},前端无需改动即可完整保留所有数位。
如果短期内无法改后端怎么办?
- 前端不要直接用
response.json(),改为读取await response.text(),再配合支持大整数的解析库(例如json-bigint)将其解析为string或BigInt。 - 切忌用简单的全局正则把所有长数字硬加双引号,否则可能误伤原本就在引号内部的文本内容。
- 涉及金额时同理:尽量以“分”(整数)或带明确小数位的字符串传输,避免浮点误差。