跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

错误处理

最后更新 查看 MarkdownAgent 设置

异常

RPC 方法抛出的错误,或用于拒绝该方法返回的 Promise 的错误,会作为新的错误对象传播到调用方。启用增强错误序列化后,Workers 会保留有效的 name 和 message,以及可序列化的自有属性,包括不可枚举属性,例如 cause ↗。

增强错误序列化 使用 enhanced_error_serialization 兼容性标志。对于 2026-04-21 或之后的兼容性日期,它默认开启。对于更早的兼容性日期,请在 RPC 提供方和消费方都添加该标志。Worker 可以使用 legacy_error_serialization 选择退出。没有增强错误序列化时,RPC 使用旧版错误重建,并且不会保留自定义自有属性。

提供方必须能够序列化错误及其自有属性值。请保持公开错误属性小且可序列化。如果某个自有属性包含不可序列化的值,Workers 不保证增强错误详情会到达消费方。

在消费方,将错误的可序列化字段视为 RPC 契约。Workers 不保留或不保证:

  • 源对象的身份、自定义原型或构造函数。
  • instanceof 检查的结果,尤其是对自定义错误类。
  • 原型方法或属性描述符。
  • 提供方的原始堆栈跟踪。消费方可能看到来自错误重建的新堆栈。
  • 不可序列化的属性值。

例如,ProviderError extends Error 的实例到达时,name 可能为 "ProviderError",并带有如 code 这样的可序列化自有字段,但它不是消费方 ProviderError 类的实例。请检查 name 和 code 等已记录字段,而不是依赖类身份。

附加属性

对于某些远程异常,运行时可能向传播的异常添加属性,例如重试或 Durable Object 元数据。这些属性与提供方的自定义属性分开。详情请参阅 Durable Object 错误处理。

这篇文档对您有帮助吗?