JavaScript 中 BigInt 类型在 JSON 序列化时的处理方案-js教程-PHP中文网

bigint 不能直接 json 序列化，需转字符串或带标记对象处理；推荐 tostring() 转换并配合 replacer/reviver 实现安全序列化与反序列化，避免转 number 导致精度丢失。

javascript 中 bigint 类型在 json 序列化时的处理方案

BigInt 类型不能直接被 JSON 序列化，调用 JSON.stringify() 会抛出 TypeError: Do not know how to serialize a BigInt。这是由于 JSON 标准本身不支持 BigInt，必须手动处理。

将 BigInt 转为字符串再序列化

最常用且安全的做法是将 BigInt 值转为字符串（.toString()），避免精度丢失。BigInt 本质是任意精度整数，转成字符串能完整保留数值，后续解析时再用 BigInt() 恢复。

在 JSON.stringify() 的第二个参数（replacer）中识别 BigInt 并转换：

const obj = { id: 123n, count: 9007199254740991n };
JSON.stringify(obj, (key, value) => typeof value === 'bigint' ? value.toString() : value);
// → '{"id":"123","count":"9007199254740991"}'

自定义序列化与反序列化函数

若项目中频繁使用 BigInt，可封装统一的序列化/解析逻辑，兼顾可读性与类型恢复。

Java Maven Secondary Analysis

分析ZIP压缩包或GitLab仓库中的Java Maven项目，确定二次开发范围、类数量、模块分布及生产相关指标。

下载

序列化：遍历对象，把所有 BigInt 替换为带标记的对象，例如 { "$bigint": "123" }
反序列化：用 JSON.parse() 的 reviver 参数识别标记并还原为 BigInt

function serializeBigint(obj) {
return JSON.stringify(obj, (k, v) => typeof v === 'bigint' ? { $bigint: v.toString() } : v);
}
function parseBigint(json) {
return JSON.parse(json, (k, v) => v?.['$bigint'] !== undefined ? BigInt(v['$bigint']) : v);
}

注意 Number 与 BigInt 的边界问题

不要把 BigInt 转成普通 Number 再序列化，这会导致溢出或精度丢失——JavaScript Number 最大安全整数是 2^53 - 1，超出后无法精确表示。

错误示例：JSON.stringify({ x: 9007199254740992n }) 若强行转 Number，结果可能是 9007199254740992（看似一样，但已不可靠）
更危险的是极大 BigInt，如 1234567890123456789012345678901234567890n，转 Number 直接变成 Infinity 或错误值