当前位置：首页 > 全部内容 > JavaScript中BigInt类型JSON序列化报错的解决方案

JavaScript中BigInt类型JSON序列化报错的解决方案

作者：青柠时间：2026-10-31 11:11:34浏览：559

本文介绍在JavaScript中将BigInt类型转换为JSON字符串时遇到的序列化错误问题。通过自定义JSON.stringify的replacer参数，遍历对象属性并将BigInt值转换为字符串，从而解决序列化异常。同时详细解析了JSON.stringify和JSON.parse的语法、参数及执行顺序，提供完整的代码示例。

针对JavaScript中BigInt类型在转换为JSON字符串时抛出无法序列化错误的问题，常见的解决思路是将BigInt数据转换为字符串。对于单独的BigInt变量，直接调用toString方法即可转为字符串；若BigInt位于对象内部，则需要更通用的处理方案。网上提供了一种封装良好的方法，具体实现如下。

export default function objReplacer(key, value) {
  if (typeof value === 'bigint') {
      return value.toString();
  } else if (typeof value === 'object') {
      for (const k in value) {
          if (typeof value[k] === 'bigint') {
              value[k] = value[k].toString();
          } else if (typeof value[k] === 'object') {
              value[k] = objReplacer(k, value[k]); // 递归处理嵌套对象
          }
      }
  }
  return value;
}
import objReplacer from "src/utils/bingintToString"
JSON.stringify(res,objReplacer)

扩展阅读

JavaScript JSON序列化和反序列化

概述

JSON序列化是指将JSON对象转换为JSON字符串的过程。在JavaScript中实现这一过程主要有两种方式：一是调用JSON对象内置的stringify()函数，二是为对象自定义toJSON()函数。

JSON反序列化是指将JSON字符串还原为JSON对象。其实现方式同样有两种：一是使用JSON对象内置的parse()函数，二是使用eval()函数。

序列化

方式一：JSON.stringify()

语法

JSON.stringify(value, replacer, space)

参数说明如下：

value：需要处理的值，可以是对象或数组。

replacer：可选参数。

  • 如果该参数是一个函数，表示在序列化过程中，被序列化值的每个属性都会经过该函数的处理；
  • 如果该参数是一个数组，表示只有包含在这个数组中的属性名才会被序列化到最终的JSON字符串中；
  • 如果该值为null或者未传递，则value参数对应值的所有属性都会被序列化。

space：可选参数。用于指定缩进用的空白字符串，以美化输出。

  • 如果参数是一个数字，则代表有多少个空格，上限值为10；
  • 如果该参数的值小于1，则意味着没有空格；
  • 如果参数为字符串，则取字符串的前十个字符作为空格；
  • 如果没有传入参数或者传入的值为null，将没有空格。
var obj = {
    name: "xiaoming",
    age: 18,
    sex: true,
    address: ["广东省", "广州市"]
};
var jsonStr = JSON.stringify(obj);
console.log(jsonStr); 
//{"name":"xiaoming","age":18,"sex":true,"address":["广东省","广州市"]}

使用2个参数

var obj = {
    name: "xiaoming",
    age: 18,
    sex: true,
    address: ["广东省", "广州市"]
};
function replacerFn(key, value) {
    if (typeof value === "string") {
        return value.toUpperCase();
    }
    return value;
}
var jsonStr = JSON.stringify(obj, replacerFn);
console.log(jsonStr);
//{"name":"XIAOMING","age":18,"sex":true,"address":["广东省","广州市"]}


var obj = {
    name: "xiaoming",
    age: 18,
    sex: true,
    address: ["广东省", "广州市"]
};
var jsonStr = JSON.stringify(obj, ["name", "age"]);
console.log(jsonStr);
//{"name":"xiaoming","age":18}

使用3个参数

var obj = {
    name: "xiaoming",
    age: 18,
    sex: true,
    address: ["广东省", "广州市"]
};
function replacerFn(key, value) {
    if (typeof value === "string") {
        return value.toUpperCase();
    }
    return value;
}
var jsonStr = JSON.stringify(obj, ["name", "age"], 10);
console.log(jsonStr);

JavaScript JSON序列化和反序列化

var obj = {
    name: "xiaoming",
    age: 18,
    sex: true,
    address: ["广东省", "广州市"]
};
function replacerFn(key, value) {
    if (typeof value === "string") {
        return value.toUpperCase();
    }
    return value;
}
var jsonStr = JSON.stringify(obj, ["name", "age"], "@@@");
console.log(jsonStr);

JavaScript JSON序列化和反序列化

其他情况

var jsonStr = JSON.stringify([new Number(1), new String("false"), new Boolean(false)]);
console.log(jsonStr); 
//[1,"false",false]
var jsonStr = JSON.stringify({
    x: undefined,
    y: Object,
    z: Symbol("")
});
console.log(jsonStr);
//{}
var jsonStr = JSON.stringify([undefined, Object, Symbol("")]);
console.log(jsonStr);
//[null,null,null]

方式二：自定义toJson

如果一个被序列化的对象拥有toJSON()函数，那么toJSON()函数就会覆盖默认的序列化行为，被序列化的值将不再是原来的属性值，而是toJSON()函数的返回值。

toJSON()函数用于更精确地控制序列化过程，可以看作是对stringify()函数的补充。

var obj = {
    name: "xiaoming",
    age: 18,
    sex: true,
    address: ["广东省", "广州市"],
    toJSON: function() {
        return {
            Name: this.name,
            Age: this.age,
            Sex: this.sex
        };
    }
};
var jsonStr = JSON.stringify(obj);
console.log(jsonStr);
//{"Name":"xiaoming","Age":18,"Sex":true}

序列化顺序

序列化处理的顺序如下：

  • 如果待序列化的对象存在toJSON()函数，则优先调用toJSON()函数，以toJSON()函数的返回值作为待序列化的值，否则返回JSON对象本身。
  • 如果stringify()函数提供了第二个参数replacer，则对上一步的返回值经过replacer参数处理。
  • 如果stringify()函数提供了第三个参数，则对JSON字符串进行格式化处理，返回最终的结果。

反序列化

方式一：JSON.parse()

语法

JSON.parse(text, reviver)

参数说明如下：

text：待解析的JSON字符串。

reviver：可选参数。

  • 如果是一个函数，则规定了原始值在返回之前如何被解析改造。
  • 如果被解析的JSON字符串是非法的，则会抛出异常。

仅一个参数使用

var arrStr = '[1,true,"hello"]';
var arr = JSON.parse(arrStr);
console.log(arr); //[1, true, "hello"]
var objStr = `{
"name":"xiaoming",
"age":18,
"address":"beijing"
}`;
var obj = JSON.parse(objStr);
console.log(obj); //{name: "xiaoming", age: 18, address: "beijing"}
var a = "12.34";
var result = JSON.parse(a);
console.log(result); //12.34

使用2个参数

var objStr = `{
"name":"xiaoming",
"age":18,
"address":"beijing"
}`;
var result = JSON.parse(objStr, function(key, value) {
    if (key === "name") {
        return value + "先生";
    }
    if (key === "age") {
        return value + "岁";
    }
    return value;
});
console.log(result); //{name: "xiaoming先生", age: "18岁", address: "beijing"}

方式二eval()

eval()函数用于计算JavaScript字符串，并把它作为脚本来执行。

语法

eval("(" + str + ")")

说明

这里为什么要使用括号将拼接出来的字符串括起来呢？

因为JSON字符串是以“{}”表示开始和结束，在JavaScript中它会被当作一个语句块来处理，所以必须强制将它处理成一个表达式，所以采用括号。

使用示例

var objStr = `{
"name":"xiaoming",
"age":18,
"address":"beijing"
}`;
var result = eval("(" + objStr + ")");
console.log(result); //{name: "xiaoming先生", age: "18岁", address: "beijing"}

到此这篇关于js中的bigint类型转化为json字符串时报无法序列化的问题的文章就介绍到这了,更多相关js bigint类型转化json字符串报无法序列化内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站！

作者最新文章

ES6模块化中js文件怎么用import和export交互

2026-11-05 17:00:48

JS读取本地文件时报错或无响应的常见原因

2026-11-05 16:32:31

let、const与var的区别：JavaScript变量声明最佳实践

2026-11-05 14:16:38

JS中直接定义静态二维数组的字面量写法

2026-11-05 14:16:08

JS 怎么查找字符串中所有匹配项的位置

2026-11-05 14:15:53

相关标签：

修复javascript错误方案