JavaScript中JSON.stringify遇到循环引用对象时怎么防止抛出死循环报错-js教程-PHP中文网

json.stringify遇循环引用会立即抛错而非死循环，因引擎在入口阶段检测到重复内存地址即终止；须用weakmap+replacer提前拦截或先调用structuredclone解环再序列化。

javascript中json.stringify遇到循环引用对象时怎么防止抛出死循环报错

JSON.stringify 遇到循环引用会直接抛错，不是卡在“死循环”里，而是引擎在序列化入口阶段就检测到重复内存地址，立刻终止并报 TypeError: Converting circular structure to JSON。它根本不会进入无限递归，所以这不是性能问题，而是格式校验失败。防止报错的关键，是在 stringify 执行前或执行中主动拦截重复对象引用。

用 WeakMap + replacer 提前拦截

这是最轻量、可控且不污染原始数据的通用做法。核心是：用 WeakMap 记录已遍历的对象引用，replacer 函数在每次访问值时检查是否见过它。

只对 typeof value === 'object' && value !== null 的值做检查，跳过函数、undefined、Symbol 等本就不合法的类型
WeakMap 不会造成内存泄漏，键是对象引用，值可任意（如 true 或占位符）
若已存在，返回 '[Circular]'（便于定位）、null（保留字段但置空）或 undefined（彻底剔除该字段）

示例：

输入关键词，自动扫描全网用户痛点，生成PRD并输出OpenClaw标准任务JSON。

搜索网络用户痛点并输出PRD文档JSON

下载

const seen = new WeakMap();
const replacer = (key, value) => {
  if (typeof value === 'object' && value !== null) {
    if (seen.has(value)) return '[Circular]';
    seen.set(value, true);
  }
  return value;
};
JSON.stringify(obj, replacer);

优先用 structuredClone 先解环再序列化

现代环境（Chrome 98+ / Firefox 94+ / Node.js 17.0+）推荐这条路径：structuredClone 本身就能安全处理循环引用、Map、Set、Date 等，生成的是一个无环的新对象，之后再 JSON.stringify 就不会出错。

调用 structuredClone(obj) 得到深拷贝，原始循环已被“展开”为独立引用
接着 JSON.stringify(structuredClone(obj)) 即可安全输出字符串
注意：structuredClone 不支持函数、undefined、BigInt、Promise —— 这些本来也不属于 JSON 合法类型，需提前过滤或替换

调试时直接用 console.dir 查看结构

不需要序列化也能看清循环关系。浏览器控制台的 console.dir(obj, { depth: null }) 内置了循环检测，会把重复引用标为 [Circular]，支持交互式展开，比硬写 replacer 更快定位问题源头。

配合 structuredClone(obj) 一起试：如果 clone 成功，说明是良性循环，可安全克隆；如果也报错，则可能含 DOM 节点、window、MobX observable 等不可克隆对象
看到 [Circular] 标记后，就能快速判断是设计使然（如父子关系），还是意外引入的冗余引用