异步接口别掩盖取消语义

看到一个 async fn,调用方很容易形成直觉:不再需要结果时,丢掉 Future 就等于取消操作。这个理解只对了一半。Future 不再被轮询,当前 Rust 代码会停止向前执行,但已经发出的网络请求、交给线程池的阻塞任务或已经提交的数据库写入,未必随之停止。接口若不说明这层差别,取消和超时就会变成难查的状态问题。
返回类型没有表达全部语义
下面这个签名能看出成功值和错误类型,却看不出取消后会发生什么:
async fn fetch_name(id: Id) -> Result<String, FetchError>
如果函数只做一次可取消的网络读取,Future 被丢弃后关闭连接,语义相对简单。若它会先写缓存、再访问远端,取消点落在两步之间时,缓存可能已经变化。若底层 SDK 把任务投到独立线程,Future 消失也可能只是没人接收结果,线程仍会继续工作。公共接口的文档需要说明副作用在哪一步发生、取消是否向下传播,以及资源最迟何时释放。
还要区分取消、超时和业务失败。超时通常由调用方停止等待触发,它不能证明服务端没有完成;业务失败则是操作已经结束,并返回了确定结果。把三者都压成同一个 FetchError::Failed,调用方就无法决定重试是否安全,也无法解释为什么超时后数据仍发生变化。
先判断操作能不能撤销
纯查询通常可以在取消后放弃结果,最多留下短暂的远端计算。带副作用的操作则要更谨慎。创建订单、发送通知、写入文件等动作一旦越过提交点,取消只能停止后续工作,不能假装前面没有发生。此时接口可以返回任务标识,让调用方查询最终状态;提交请求使用幂等键,重试时也不会产生第二份副作用。
如果业务确实支持撤销,应把撤销设计成独立操作,并说明它可能失败,而不是把它藏在 Future 的析构里。析构不能等待异步网络往返,进程崩溃时也未必有机会执行完整补偿。可靠的撤销需要持久状态和可重试的处理流程。
子任务要跟着父任务收口
异步函数内部启动子任务时,最容易破坏取消语义。直接 spawn 后不保存句柄,父 Future 即使被取消,子任务仍会运行。代码评审要检查每个派生任务由谁等待、谁取消、错误返回到哪里。适合随请求结束的任务,应纳入同一个作用域;必须脱离请求运行的后台任务,则交给有生命周期管理的组件,不要悄悄悬空。
资源清理也应围绕取消点设计。锁守卫、临时文件和连接借用要在 Future 被丢弃时可靠释放;半成品文件可先写入临时路径,完成后再原子替换;流式协议需要让对端知道本地停止消费,避免服务端继续发送到无人读取的连接。
测试要主动丢弃 Future
只测试正常 await 和错误返回,覆盖不到取消。可以让函数停在每个关键等待点,随后丢弃 Future,检查子任务、连接、锁和临时文件的状态。对带写入的接口,还要确认提交前取消不会产生结果,提交后取消能够通过任务查询得到最终状态。再加入超时与重复请求,验证调用方不会把“不知道结果”误判成“确定失败”。
日志中应把 cancelled、deadline_exceeded 和业务错误分开,并带上任务标识。否则大量“请求失败”既无法反映真实服务质量,也无法找出取消后仍在运行的孤儿任务。
异步接口的好坏,不只看调用方式是否简洁。调用者必须知道停止等待会造成什么、哪些副作用已经不可逆、后续到哪里查询。把这些写进接口契约,取消才是可用的控制能力,而不是一个看起来自然、实际含糊的默认行为。
1320



被折叠的 条评论
为什么被折叠?



