PuppyIP 资源中心
云服务运维 5 分钟 发布于 2026-11-14

Cloudflare Workers request.signal:11 月 17 日默认变更与 fetch 取消

11 月 17 日的新默认取决于 Worker 的兼容日期。request.signal 可通知客户端断开;要让下游 fetch 响应取消,仍需显式传递信号。

Cloudflare Workers request.signal AbortSignal 兼容日期

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 2026-11-17 起,兼容日期为 2026-11-17 或之后的 Workers 默认会通过 request.signal 收到客户端断开事件。
  • 截至 2026-11-14,这项默认变更尚未到生效日;已有 Worker 会保持当前行为,直到兼容日期或标志发生变化。
  • abort 事件只是断开通知;要让出站 fetch 响应该信号,需显式传入 { signal: request.signal }。
  • request_signal_passthrough 是单独的兼容标志,此次默认变更不会启用它。
  • 按 Worker 检查日期、标志和下游 API 的取消支持;信号不会撤回已完成操作,也不是账单上限。

默认变更什么时候生效

Cloudflare 在 2026 年 11 月 2 日的公告说明:从 2026 年 11 月 17 日起,兼容日期为 2026-11-17 或之后的 Workers,会默认通过入站请求的 request.signal 收到客户端断开事件。对于这些兼容日期,只为接收该事件不再需要设置 enable_request_signal。

这项规则按每个 Worker 的兼容日期判断。截至 2026 年 11 月 14 日,公告中的生效日仍在未来;不能根据日历或代码上线日期推断某个部署已启用新行为。

已有 Worker 要看自己的日期和标志

已有 Worker 保留当前行为,直到兼容日期或相关标志发生变化。先核对目标 Worker 实际运行的配置;同一项目中的不同 Worker 也可能使用不同日期和标志。

若兼容日期早于 2026-11-17,想提前试用可以添加 enable_request_signal。若兼容日期为 2026-11-17 或之后、但需要维持旧行为,则可添加 disable_request_signal;修改前先核对具体 Worker 使用的标志,避免误把一个部署的结果套到另一个部署。

abort 事件是一条可处理的取消通知

客户端断开时,入站请求的 AbortSignal 会触发 abort 事件。Worker 可以监听它来记录断开,或清理由这次请求创建且仍由自己管理的资源;监听事件能让应用有机会响应,但需要由代码定义合适的清理边界。

收到事件不等于每段代码、每个 Promise 或远端服务都被强制中断。只有观察并处理取消信号的工作才能据此响应;队列任务和远端写入仍有各自的生命周期。

需要把信号传给出站 fetch

默认收到入站信号,不代表它会自动附着到每一个出站请求。若要让支持 AbortSignal 的 fetch 响应客户端断开,需要显式传递,例如 fetch(url, { signal: request.signal });也要确认信号传到了实际执行网络请求的那一层。

request_signal_passthrough 是另一项兼容标志,此次默认变更不会启用它。公告给出的做法是显式传递信号;不要把“Worker 收到通知”误当成“下游已经取消”。

用低风险路径核对实际行为

先选择不会写入业务数据的低风险测试路由,断开测试客户端并观察 abort 是否触发。再单独检查出站 fetch 是否拿到该信号、是否报告取消。Worker 日志只能证明事件被观察到,不能单凭它推断远端服务已停止。

这项能力提供取消信号,不是账单上限,也不会回滚已经完成的业务操作;公告没有承诺自动节省费用或提升性能。对涉及写入的请求,仍需按系统自身规则判断哪些操作已完成、哪些需要继续处理或恢复。

资料来源

常见问题

11 月 17 日按哪个时区、几点切换?

所核对的公告和兼容性文档给出了 2026-11-17 这一日期,没有给出具体切换时刻或时区。判断单个 Worker 时仍以兼容日期、标志和实际行为为准,不能据此编排一个全账户统一切换时间。

公告是否列出了额外费用、套餐或地区限制?

这几份文档没有列出该项变更的额外费用或特定套餐、地区排除项。这不等于已核验所有账户的可用性;涉及账户条件时,应以自己的配置和当前官方说明为准。