JSON.stringify()直接序列化循环引用对象会报错，因JSON标准不支持循环引用；可通过replacer函数跳过、structuredClone克隆、自定义ID映射或服务端引用协议解决。
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等类型：
立即学习“Java免费学习笔记（深入）”；
- 直接调用
structuredClone(obj)即可获得深拷贝，无需序列化为字符串 - 若必须转为JSON字符串，可先克隆再用
JSON.stringify()（前提是克隆后无循环——但克隆本身已解除了原始循环） - 注意：
structuredClone不支持函数、undefined、BigInt、Promise等，遇到会抛错，需提前清理
服务端协同：序列化时约定引用协议
前后端协作场景下，可设计轻量引用协议，提升可读性与调试性：
- 序列化时将循环对象替换为
{ "$id": "user1", "$ref": "user1" }格式 - 服务端解析时识别
$id注册对象，遇到$ref则查表注入引用 - 比二进制或自定义编码更易调试，也便于与其他语言系统对接
