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 任务工具统一使用。

toml
[dependencies]
tokio = { version = "1", features = ["macros", "rt-multi-thread", "time"] }
tokio-util = { version = "0.7.19", features = ["rt"] }

这段依赖配置提供 Tokio 运行时、定时器、宏以及 tokio-util 的运行时相关工具。保存后可用 cargo run 编译并执行下面的完整程序。

rust
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());
}

预期输出

text
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 被丢弃”来完成全部收尾。更稳妥的做法是让取消分支跳出主循环,再执行刷新缓冲区、关闭协议会话或提交最终状态等清理逻辑。

如果某项操作本身不可安全取消,应把取消检查放在操作边界,而不是随意中断它。结构化取消解决的是“谁通知谁停止”和“停止意图怎样传播”,真正可靠的关闭还需要每个任务定义自己的安全退出点。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

传播结构化取消

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通