Workers 断连信号将默认启用:取消与提交的边界

Workers 将对新兼容日期默认提供断连信号。本文分析取消传播、已提交任务的恢复,以及灰度发布时需要验证的业务边界。

11月2日,Cloudflare 宣布,兼容日期为2026-11-17或更晚的 Workers 将默认通过 request.signal 接收客户端断连事件。旧服务在日期或标志未变时保持原行为,提前试用可启用 enable_request_signal。这不是所有服务在某天同时被强制切换。官方公告

对架构设计而言,这次更新让一个长期被忽略的问题更容易被看见:浏览器不再等待结果之后,服务器还有哪些工作值得继续?本文从业务生命周期分析这一变化,以下建议不是针对具体应用完成的测试结论。

断开连接,不等于撤销业务

用户关闭页面,可能是在取消搜索,也可能只是网络切换。服务器看到的是连接状态,未必知道用户真实意图。因此,不应把断连事件直接解释为删除任务、回滚订单或撤销已经提交的数据。技术信号与业务指令必须分开建模。

建议先按结果用途划分工作。一类只为当前页面提供临时结果,例如聚合搜索、预览生成或尚未提交的计算;另一类已经成为系统接受的业务任务,例如产生报告后通知用户。前者可以随等待者退出而停止,后者应由自己的状态与完成条件决定是否继续。

先定义系统何时算接单

以异步报表为例,页面收到任务编号之前,服务是否已经持久化请求?如果已经接单,客户端断连后再次点击创建,应能找回同一个任务或获得清晰的状态,而非悄悄启动第二份。若尚未接单,则需要明确失败提示与重新提交方式。这是应用层需要建立的协议,断连信号不会自动补齐。

任务状态可至少区分待处理、执行中、成功、失败和明确取消。只有经过业务接口确认的取消,才推进到对应状态。对无法确定是否已提交的情况,应保留查询入口,避免把一次传输失败描述为确定的业务失败。

取消要沿调用链传递,不能只记一条日志

Cloudflare 的公告特别说明,本次默认值变更不会开启 request_signal_passthrough。要取消支持信号的下游操作,需要显式传入 request.signal。因此,“能收到断连事件”和“依赖请求已经停止”是两个验收点。兼容性说明

为每条分支标注停止条件

假设一个搜索接口同时查询三个服务,再合并结果。页面离开后,若只终止外层等待,而三个请求继续运行,资源节约就没有真正发生。设计评审应逐项检查请求包装函数是否接受信号、重试逻辑是否尊重取消,以及结果合并阶段是否还会继续启动新工作。

这不意味着把同一个信号不加区分地传给所有分支。缓存更新、审计记录或已接受任务的执行,可能有独立完成要求。较稳妥的方式是在接口边界明确哪些分支从属于当前响应,哪些已经由其他机制接管,并为两类工作分别记录状态。

取消请求不能证明远端没有产生效果

本地停止等待时,远端可能已经完成写入,只是响应尚未返回。对于创建资源等有副作用的操作,仍需幂等键、状态查询或补偿设计。不能因为收到了取消异常,就立即用新编号重做同一个操作,否则可能把一次网络中断变成重复数据。

重试策略也要区分主动取消和服务故障。用户已不再等待的只读请求,通常没有理由被自动重试拉回执行;已提交的任务则应按其业务策略恢复。把两者混入同一个“异常就重试”的包装层,会掩盖真实边界。

清理动作必须短小、可重复

Request API 文档说明,应用可以监听断连事件,在调用结束前清理资源或记录日志。工程上应优先让这些处理容易完成,不把新的长流程塞进清理回调,更不把它当成可靠的业务结算入口。

可释放的对象包括应用自己持有的临时资源与监听器,但具体操作仍需遵循所用库的接口。清理函数应能处理资源尚未创建、已经关闭、或正常完成与取消几乎同时发生的情况。即使某一步失败,也应留下足以定位的问题信息,避免吞掉所有异常。

用状态转换处理竞争

最常见的边缘情况是结果刚产生,连接同时断开。测试不能只覆盖“开始后马上取消”,还应覆盖结果返回前、部分流已发送、下游已完成但外层未结束等时点。每种情况都要明确最终状态,不能让一次任务同时被记为成功与取消。

如果代码使用共享对象,应把取消限定在对应请求的资源上。一个客户端离开,不应顺带关掉仍服务其他用户的连接或缓存。测试中加入两个并发请求,可以更容易暴露这种错误的所有权假设。

观测资源节约,也要观测误取消

上线后只统计断连次数没有足够解释力。更有价值的是对照入口请求、取消信号、下游结束和业务状态,识别取消是否真正减少无效工作。日志可以用请求编号关联,但应避免记录完整敏感输入,把排障需要与数据最小化一起考虑。

同时观察正常完成率、重复提交和用户重试。若资源使用下降,却出现更多任务丢失或页面反复加载,就不能把结果简单归功于优化成功。移动网络切换、代理超时与用户主动退出都可能影响连接,分析时需要结合实际链路,而不是猜测用户行为。

先做小范围对照

建议选一个副作用少、成本可观察的只读接口试点,保留原配置作为对照。验证断连能被识别、支持取消的下游能停止、正常请求不受影响,再扩大到聚合接口。对写入链路,应先补齐任务查询与幂等保障,再考虑更积极的停止策略。

此次调整仍提供 disable_request_signal 退出选项,但回退配置不能替代修复业务状态问题。回退时也要检查正在执行的任务,确认没有因为版本切换丢失状态解释。兼容日期升级最好与其他依赖升级分开,让回归结论有明确对象。

从连接生命周期走向任务生命周期

这项更新的意义,不只是让代码多一个事件,而是推动团队把“谁还在等待”与“系统已经承诺什么”分别写清。临时查询应及时停止,已接受任务应可查询、可恢复,需要取消的业务则应有正式入口。

在十一月十七日之前,最值得完成的工作是一张调用链清单:哪些操作可取消、谁传播信号、哪里形成持久承诺、失败后到哪里查状态。把这些问题回答好,默认行为变化才会转化为可靠的资源控制,而不是新的偶发故障来源。

信息来源

本文核验截至北京时间2026年11月3日,示例场景与验收建议为独立工程分析。

相关文章

评论

登录后即可参与讨论

暂无评论。