处理JSON循环引用与自定义序列化方法

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《JavaScript JSON序列化：循环引用处理与自定义解析》，聊聊，我们一起来看看吧！

答案：使用 replacer 函数结合 WeakSet 可解决循环引用并自定义序列化逻辑，或引入 flatted 等库实现完整结构还原，同时利用 replacer 与 reviver 控制字段过滤与类型转换。

在使用 JavaScript 的 JSON.stringify() 方法进行对象序列化时，遇到循环引用会抛出错误。同时，在某些场景下，我们希望对序列化过程进行自定义控制，比如过滤字段或处理特殊类型。本文将说明如何解决循环引用问题，并实现自定义的 JSON 序列化与解析逻辑。

循环引用导致的问题

当一个对象的属性直接或间接引用自身时，就构成了循环引用。例如：

const obj = { name: "Alice" };
obj.self = obj;
JSON.stringify(obj); // 抛出 TypeError: Converting circular structure to JSON

浏览器和 Node.js 环境下的原生 JSON.stringify 无法处理这种结构，会立即中断并报错。

解决方案：使用 replacer 函数过滤引用

可以通过传入 replacer 函数来跳过特定属性。虽然不能直接检测所有循环引用，但可以结合 WeakSet 手动追踪已访问的对象：

function stringifySafe(obj) {
  const seen = new WeakSet();
  return JSON.stringify(obj, (key, value) => {
    if (typeof value === "object" && value !== null) {
      if (seen.has(value)) {
        return "[Circular]";
      }
      seen.add(value);
    }
    return value;
  });
}

这个方法能在序列化过程中识别重复引用，避免崩溃，同时用标记字符串代替循环部分，保留其余数据结构。

使用第三方库简化处理

对于复杂项目，推荐使用专门处理循环引用的库，如 flatted 或 cycle。

以 flatted 为例：

import { stringify, parse } from 'flatted';

const obj = { name: "Bob" };
obj.self = obj;

const str = stringify(obj); // 成功序列化
const recovered = parse(str); // 正确还原结构

这类库通过扁平化结构记录引用关系，能完整保存和恢复循环引用，适合需要精确还原的场景。

自定义序列化与反序列化逻辑

除了处理循环引用，有时还需控制哪些字段被序列化，或转换日期、函数等非标准类型。

replacer 和 reviver 参数提供了这样的能力：

• replacer：在序列化前筛选或转换值
• reviver：在反序列化后修正或重建值

const user = {
  name: "Charlie",
  password: "123456", // 敏感字段
  createdAt: new Date()
};

// 自定义序列化：隐藏密码，转换日期为时间戳
const json = JSON.stringify(user, (key, value) => {
  if (key === "password") return undefined;
  if (value instanceof Date) return value.getTime();
  return value;
});

// 反序列化时恢复日期对象
const parsed = JSON.parse(json, (key, value) => {
  if (key === "createdAt") return new Date(value);
  return value;
});

这样可以在传输中精简数据，同时保证关键信息正确重建。

基本上就这些。处理循环引用和自定义解析并不复杂，关键是理解 replacer 与 reviver 的执行时机，并根据需求选择手动控制或引入可靠工具库。

本篇关于《处理JSON循环引用与自定义序列化方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！