Rust / 系统课时
传播结构化取消
传播结构化取消
异步服务关闭时,真正困难的不是“发出一个停止信号”,而是让连接任务、后台任务和更深层子任务按同一生命周期协同退出。本节用 CancellationToken 建立可传播的取消树,并区分共享令牌与子令牌的边界。
学习目标
- 使用
CancellationToken向多个异步任务传播停止意图 - 区分
clone()与child_token()的取消范围 - 用
tokio::select!让任务在工作与取消之间安全响应
把停止意图组织成树
结构化取消的关键是让任务层级和取消层级尽量一致。服务根令牌代表“整个进程要停”,连接令牌代表“这个连接要停”,请求令牌再代表连接内部的一项工作。父令牌取消会向后代传播,而单独取消子令牌不会反向取消父节点。

CancellationToken::cancel() 只是发布取消意图,不会强制杀死任务。任务必须在可让出执行权的位置观察 cancelled(),然后自行完成清理并返回;如果任务长时间做同步阻塞或纯 CPU 循环,取消信号不会让它自动停下。
用 CancellationToken 传播取消
下面示例基于 tokio-util 0.7.19。CancellationToken 位于 tokio_util::sync;这里同时启用 rt feature,便于与 Tokio 任务工具统一使用。
[dependencies]
tokio = { version = "1", features = ["macros", "rt-multi-thread", "time"] }
tokio-util = { version = "0.7.19", features = ["rt"] }这段依赖配置提供 Tokio 运行时、定时器、宏以及 tokio-util 的运行时相关工具。保存后可用 cargo run 编译并执行下面的完整程序。
use std::time::Duration;
use tokio::time::sleep;
use tokio_util::sync::CancellationToken;
async fn worker(name: &'static str, token: CancellationToken) -> &'static str {
loop {
tokio::select! {
_ = token.cancelled() => return name,
_ = sleep(Duration::from_millis(20)) => {
// 模拟可中断的异步工作;下一轮继续检查取消信号。
}
}
}
}
#[tokio::main]
async fn main() {
let root = CancellationToken::new();
// child_token 建立父 -> 子的单向取消传播关系。
let connection = root.child_token();
let background = root.child_token();
let request = connection.child_token();
let connection_handle =
tokio::spawn(worker("connection stopped", connection.clone()));
let background_handle = tokio::spawn(worker("background stopped", background));
let request_handle = tokio::spawn(worker("request stopped", request.clone()));
// 单独取消请求,不会把 connection 或 root 一起取消。
request.cancel();
println!("{}", request_handle.await.unwrap());
println!("root cancelled: {}", root.is_cancelled());
// 根令牌取消后,连接和后台任务都会收到停止意图。
root.cancel();
println!("{}", connection_handle.await.unwrap());
println!("{}", background_handle.await.unwrap());
}预期输出
request stopped
root cancelled: false
connection stopped
background stopped输出先证明子令牌可以独立停止,再证明根令牌能一次通知不同分支。任务何时真正返回仍取决于它们何时再次轮询取消 future,而不是 cancel() 调用本身替任务执行清理。
选择 clone 还是 child_token
| 操作 | 生命周期关系 | 取消效果 |
|---|---|---|
token.clone() |
同一个取消节点的另一个句柄 | 任一 clone 调用 cancel(),其他 clone 会观察到同一取消状态,后代也会被取消 |
token.child_token() |
创建新的子节点 | 父节点取消会传播到子节点;子节点取消不会反向影响父节点 |
同一个连接任务的多个协作者通常共享 clone;需要“局部可取消、整体也能统一关闭”的请求或子任务,则更适合从父令牌派生 child token。把所有任务都只拿根令牌的 clone,会失去局部取消的隔离能力。
让取消之后仍有清理机会
tokio::select! 的取消分支应负责退出循环,但需要异步清理时不要直接依赖“future 被丢弃”来完成全部收尾。更稳妥的做法是让取消分支跳出主循环,再执行刷新缓冲区、关闭协议会话或提交最终状态等清理逻辑。
如果某项操作本身不可安全取消,应把取消检查放在操作边界,而不是随意中断它。结构化取消解决的是“谁通知谁停止”和“停止意图怎样传播”,真正可靠的关闭还需要每个任务定义自己的安全退出点。