处理循环引用对象的序列化方法

JavaScript中JSON.stringify()无法直接处理循环引用对象，会抛出TypeError错误，这是因为JSON标准本身不支持对象间的相互引用；文章系统介绍了四种实用解决方案：使用replacer函数跳过循环字段以避免报错（但丢失引用关系）、通过自定义ID映射实现“标记-替换-恢复”流程以完整保留并还原循环结构（可借助flatted等成熟库）、利用现代浏览器和Node.js支持的structuredClone()原生深拷贝（高效且支持多种内置类型，但需注意兼容类型限制），以及前后端协同采用带$id/$ref的轻量引用协议提升可读性与跨语言兼容性——无论你是调试本地数据、构建序列化工具，还是设计API交互规范，这些方法都能帮你安全、灵活地应对循环引用这一常见难题。

JavaScript中直接使用JSON.stringify()序列化含循环引用的对象会抛出TypeError: Converting circular structure to JSON错误。根本原因是JSON标准不支持对象间相互引用，而JavaScript原生对象可以自由建立引用关系。

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

通过JSON.stringify()的第二个参数replacer，可在遍历过程中识别并过滤掉重复引用的属性：

• 维护一个WeakMap记录已访问的对象，键为对象引用，值为占位标识（如"[Circular]"）
• 在replacer中检查当前值是否已在WeakMap中，若是则返回占位符或undefined（后者可跳过该字段）
• 注意：此法仅避免报错，不保留原始引用结构，反序列化后无法还原循环关系

采用结构化克隆与引用映射重建

若需完整保留引用关系并支持反序列化，需手动实现“标记-替换-恢复”流程：

• 第一次遍历对象图，为每个唯一对象分配唯一ID（如递增数字或Symbol），用Map记录object → id
• 第二次遍历，将对象实例替换为{ $ref: "id123" }形式的引用标记
• 序列化结果为纯JSON；反序列化后，再按ID映射表将$ref还原为实际引用
• 可用库如flatted或cycle已封装该逻辑，轻量且兼容性好

借助structuredClone（现代环境首选）

Chrome 98+、Firefox 94+、Node.js 17.0+ 支持structuredClone()，它原生支持循环引用、Map/Set、Date、RegExp等类型：

• 直接调用structuredClone(obj)即可获得深拷贝，无需序列化为字符串
• 若必须转为JSON字符串，可先克隆再用JSON.stringify()（前提是克隆后无循环——但克隆本身已解除了原始循环）
• 注意：structuredClone不支持函数、undefined、BigInt、Promise等，遇到会抛错，需提前清理

服务端协同：序列化时约定引用协议

前后端协作场景下，可设计轻量引用协议，提升可读性与调试性：

• 序列化时将循环对象替换为{ "$id": "user1", "$ref": "user1" }格式
• 服务端解析时识别$id注册对象，遇到$ref则查表注入引用
• 比二进制或自定义编码更易调试，也便于与其他语言系统对接

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《处理循环引用对象的序列化方法》文章吧，也可关注golang学习网公众号了解相关技术文章。