JavaScript 中循环引用对象怎么转换为 JSON 格式-js教程-PHP中文网

javascript中循环引用对象无法直接用json.stringify()转换，会抛出typeerror错误；根本原因是json格式不支持引用关系，导致无限递归；常用解决方案包括：①自定义replacer函数配合weakmap跳过循环引用；②现代环境可用structuredclone预处理；③第三方库如flatted可完整保留循环结构；④手动解构生成调试快照。

javascript 中循环引用对象怎么转换为 json 格式

JavaScript 中循环引用对象无法直接用 JSON.stringify() 转换，会抛出 TypeError: Converting circular structure to JSON 错误。根本原因是 JSON 格式不支持引用关系，而循环引用会让序列化过程无限递归。

用自定义 replacer 函数跳过循环引用属性

这是最常用、轻量且可控的方式：在 JSON.stringify() 的第二个参数（replacer）中识别并过滤掉已出现过的对象引用。

维护一个 WeakMap 记录已遍历的对象及其占位标识（如 "[Circular]"）
在 replacer 中检查当前值是否已在 WeakMap 中，若是则返回替代值（如 null 或字符串标记）
注意：WeakMap 只能以对象为键，天然避免内存泄漏

示例：

const seen = new WeakMap();
function getCircularReplacer() {
  return (key, value) => {
    if (typeof value === "object" && value !== null) {
      if (seen.has(value)) {
        return "[Circular]";
      }
      seen.set(value, true);
    }
    return value;
  };
}

const obj = { a: 1 };
obj.self = obj;
console.log(JSON.stringify(obj, getCircularReplacer())); // {"a":1,"self":"[Circular]"}

使用结构化克隆 + 序列化（现代环境推荐）

如果目标环境支持 structuredClone()（Chrome 98+、Firefox 94+、Node.js 17.0+），可先深拷贝去除引用关系，再安全序列化。

Java Maven Secondary Analysis

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

下载

structuredClone 能正确处理大多数内置类型（包括 Map、Set、Date、RegExp 等），但依然不支持函数、undefined、Symbol 和循环引用
所以它本身也会报错——需配合 try/catch 或先用 replacer 预处理
更稳妥的做法是：用 replacer 清除循环后，再用 structuredClone 做一次干净副本（可选）

借助第三方库（如 flatted、circular-json 已废弃）

对于复杂场景或需要反向还原（即从 JSON 再恢复带循环的对象），可使用 flatted。

安装：npm install flatted
它用数字索引代替重复引用，生成的字符串仍是合法 JSON（含额外元信息）
支持 flatted.stringify() 和 flatted.parse()，可完整保留循环结构

示例：

import { stringify, parse } from 'flatted';

const obj = { name: 'Alice' };
obj.friend = obj;

const json = stringify(obj); // '{"name":"Alice","friend":1}'
const restored = parse(json); // 恢复为带循环的对象