开发实操 · 可复现示例

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 或查错单”的隐蔽故障。

如何用工具快速复现和排查

  1. 打开浏览器 DevTools 的 Network → Response 选项卡,直接查看未经过 JSON.parse 的原始响应文本(不要看 Preview 面板,因为 Preview 已经按 JS 数值解析过了)。
  2. 复制原始文本到 JSON 格式化工具 进行格式化,同时对比原始数字与格式化后的尾数。
  3. 把原始响应和解析后的结果放到 文本差异比对工具 左右对照,能够一眼看出哪些字段的末两位被舍入成了 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。
  • 切忌用简单的全局正则把所有长数字硬加双引号,否则可能误伤原本就在引号内部的文本内容。
  • 涉及金额时同理:尽量以“分”(整数)或带明确小数位的字符串传输,避免浮点误差。
已成功复制到剪贴板