应使用WeakMap记录已冻结对象以避免无限递归，优先冻结顶层对象，必要时用Proxy替代深冻结。Object.freeze不处理循环引用，手动深冻结需去重；WeakMap可安全标记对象状态；对循环结构宜解构或截断后再冻结。

直接冻结带有循环引用的对象会触发无限递归，导致栈溢出。根本原因在于 Object.freeze 本身不处理循环引用，而如果你在 freeze 前手动遍历对象（比如深冻结逻辑），又没做引用去重，就会卡死。

避免递归冻结：用 WeakMap 记录已处理对象

实现深冻结时，必须跳过已冻结过的引用。WeakMap 是理想工具，它能以对象为键、标记状态，且不影响垃圾回收。

• 创建一个 WeakMap，键为对象，值为布尔 true 表示“已冻结”
• 每次进入对象前先查 WeakMap，存在就直接返回，不再递归
• 对当前对象调用 Object.freeze 后，立即存入 WeakMap

慎用深冻结：优先冻结顶层，而非盲目递归

绝大多数场景不需要深冻结。循环引用本身不是问题，问题常出在误以为“必须全冻住”。

CPA Update - Secure CLI Proxy API Maintenance

安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。

下载

• 只冻结你明确要保护的顶层对象，内部引用保持原样
• 若需防止属性被改，用 Object.defineProperty 配合 writable: false 控制单个属性
• 对有循环结构的数据（如树形节点、图结构），冻结前先解构为无环数据（例如只保留 id 和关系映射）

检测并截断循环引用再冻结

如果确实需要冻结整个结构，先做一次安全遍历，剥离或标记循环点。

• 用 Set 或数组记录路径上所有对象引用，遇到重复即判定为循环
• 在循环点处停止深入，改为冻结一个占位对象（如 { __circular: true }）
• 冻结完成后，原始引用关系仍在，但不会触发递归 —— 因为深冻结逻辑已主动避开

用 Proxy 替代深冻结（适用于运行时防护）

如果目标是“阻止意外修改”，Proxy 可提供更可控、可中断的拦截能力。

• 定义 handler 的 set、defineProperty 等陷阱，统一拒绝写操作
• Proxy 不会遍历属性，天然规避循环引用问题
• 注意：Proxy 对象与原对象不相等（=== 返回 false），且某些 API（如 JSON.stringify）可能无法直接处理