如何利用 BigInt 处理 64 位整型 ID 在 JSON 解析过程中的精度丢失防护

风婷吖_7086

风婷吖_7086

2026-05-18

758人浏览

原创

JavaScript处理64位ID时精度丢失必然发生,因Number仅安全表示±2⁵³−1内整数;BigInt是唯一可靠原生方案,但需配合json-bigint等库或字符串化传输规避JSON限制。

如何利用 bigint 处理 64 位整型 id 在 json 解析过程中的精度丢失防护

JavaScript 中处理 64 位整型 ID(如雪花 ID)时,精度丢失不是“会不会发生”的问题,而是“何时暴露”的问题。因为 Number 类型只能安全表示 ±253−1 范围内的整数,而典型雪花 ID(如 13579246810111213)早已超出该范围——解析后末位悄然变更,却无任何报错提示。

为什么 BigInt 是前端唯一可靠的原生方案

BigInt 是 ECMAScript 2020 正式引入的原始类型,专为任意精度整数设计。它不参与 IEEE 754 浮点运算,可精确表示 64 位甚至更大整数。但关键在于:它不能直接用于 JSON.parse / JSON.stringify,需配合定制解析逻辑才能落地。

  • JSON 标准本身不支持 BigInt,原生 JSON.stringify(BigInt(123)) 会抛出 TypeError
  • 浏览器内置 JSON.parse() 永远返回 Number,无法绕过——这是 JS 引擎层限制,后端或中间件无法干预
  • 因此,防护必须从前端接收响应那一刻开始:拦截原始字符串,跳过默认解析,改用支持 BigInt 的解析器

在 Axios 或 Fetch 中集成 json-bigint

json-bigint 是目前最成熟、零依赖的解决方案,它重写了 JSON 解析逻辑,将超限整数自动转为 BigInt(可选),同时保持对标准 JSON 的完全兼容。

jm-jsjkxyjs02-zlm-405
jm-jsjkxyjs02-zlm-405

使用约定式提交(Conventional Commits)生成标准化的 Git 提交信息。适用于以下场景: (1) 暂存更改时需要提交信息; (2) 审查 diff 时希望获得结构化摘要; (3) 编写 PR 描述或变更日志(changelog)条目; (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff,并生成按类型(type)划分范围的提交信息。

下载
  • 安装:npm install json-bigint
  • Axios 全局配置示例:
const JSONbig = require('json-bigint');
axios.defaults.transformResponse = [(data) => {
  if (typeof data === 'string') {
    try {
      return JSONbig({ storeAsString: false }).parse(data); // 返回 BigInt
    } catch (e) {
      return JSON.parse(data);
    }
  }
  return data;
}];
  • 注意:storeAsString: false 启用 BigInt;设为 true 则返回字符串(适合后端未适配 BigInt 的场景)
  • 若服务端已将 ID 字段统一改为字符串(如 "id": "13579246810111213"),则无需 BigInt,直接用字符串比对更稳妥

手动解析 + BigInt 安全兜底

当无法引入第三方库,或需精细控制字段时,可对响应体做轻量级预处理:

  • 用正则识别疑似大整数字段(如 "id":\s*\d{17,}),将其包裹引号转为字符串,再调用 JSON.parse()
  • 或使用 JSON.parse(text, (key, value) => typeof value === 'number' && value > 9007199254740991 ? BigInt(value.toString()) : value) ——但此法有风险:value 在进入 reviver 前已被转为 Number,**原始精度已在解析第一毫秒丢失**,不可取
  • 真正安全的做法是:先用 JSON.parse(text, (k, v) => typeof v === 'string' && /^\d{17,}$/.test(v) ? BigInt(v) : v),前提是后端已发字符串格式 ID

前后端协同才是根治关键

单靠前端用 BigInt 只是补救。真正健壮的方案需两端约定:

  • 后端对所有可能超 2^53−1 的字段(ID、时间戳微秒值、金额等),**强制序列化为字符串**,并在 OpenAPI 文档中标注 type: string, format: int64
  • 前端收到字符串后,按需转 BigInt(计算/比对)或保持字符串(渲染/传参),避免隐式转换
  • 数据库与 ORM 层同步调整:如 Golang 结构体字段声明为 Id string `json:"id"`,或使用 json.Number + .String() 输出,确保 JSON 输出始终是字符串

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js json

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

5586

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1349

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

5504

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1020

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

1976

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

3845

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

5053

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3320

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

1068

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.3万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习