Proxy 默认不可撤销，仅通过 Proxy.revocable() 创建的代理才可撤销；后者返回含 proxy 和 revoke 函数的对象，调用 revoke 即失效。

proxy 默认创建的是不可撤销的代理对象，而 proxy.revocable() 则专门用于生成可随时终止的代理。识别是否可撤销，关键看创建方式和是否有 revoke 函数可用。

怎么判断一个 Proxy 是否可撤销

不可撤销的 Proxy 是最常见形式，用 new Proxy(target, handler) 创建，它没有内置的“关闭开关”。一旦生成，代理行为将一直生效，无法主动禁用。

可撤销的 Proxy 必须通过 Proxy.revocable(target, handler) 创建，它返回一个对象，结构固定：

• proxy 属性：就是代理实例，用法与普通 Proxy 完全一致
• revoke 属性：是一个无参函数，调用后立即使 proxy 失效

只要没拿到 revoke 函数，就说明这个 Proxy 不可撤销。反过来，如果代码中出现了类似 const { proxy, revoke } = Proxy.revocable(...) 的写法，那它就是明确设计为可撤销的。

CPA Update - Secure CLI Proxy API Maintenance

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

下载

Proxy.revocable() 的典型使用场景

它的核心价值在于“临时授权”和“安全隔离”，适用于需要精确控制代理生命周期的场合：

• 敏感数据的一次性访问：比如某个配置对象含密钥，只允许在初始化阶段通过代理读取，初始化完成后立刻 revoke()，防止后续意外访问
• 沙箱环境中的受限执行：给第三方脚本提供对目标对象的代理访问权限，运行结束后调用 revoke 彻底切断所有操作能力，避免副作用残留
• 测试或调试时的可控拦截：在单元测试中模拟异常行为（如属性访问抛错），验证系统容错逻辑，测试一结束就 revoke 恢复原始状态
• 资源清理配合：代理封装了底层资源（如 WebSocket 连接、文件句柄），revoke 可作为清理入口，在销毁代理的同时触发资源释放逻辑（需在 revoke 后手动处理）

不可撤销 Proxy 的常见误用风险

开发者有时会误以为普通 Proxy 能“中途停用”，结果导致预期外的行为持续生效：

• 试图删除 proxy 引用或赋值为 null，并不能停止拦截——只要还有其他变量引用它，拦截依然有效
• 修改 handler 对象本身（如清空方法）无效，因为 Proxy 在创建时已绑定 handler 的快照，后续改 handler 不影响已有代理
• 想用 Object.freeze(proxy) 来禁用 set 操作？不行，freeze 只影响自有属性，不干扰 Proxy 的拦截逻辑

这些情况恰恰反向说明：当业务需要“可中断”语义时，Proxy.revocable() 不是备选，而是必需。