Rust / 系统课时

等待任务有序退出

等待任务有序退出

停止接收新工作后,服务还要回答另一个问题:已经接收的任务什么时候才算真正结束。本节使用 TaskTracker 跟踪存量任务,并用最终关闭截止时间限制等待过程,避免优雅关闭无限期挂住。

学习目标

  • 使用 TaskTracker 跟踪并等待已启动任务退出
  • 正确理解 close()、停止接收新工作与 wait() 的关系
  • 用 tokio::time::timeout 为最终关闭设置截止时间

把关闭拆成三个阶段

有序关闭通常按“停止接收 → 等待存量 → 超时升级”推进。先让监听循环不再创建新连接或新请求,再关闭 tracker 的等待窗口,最后等待当前任务归零;如果超过总截止时间,则进入日志告警、强制取消或进程退出等升级策略。

停止接收新工作后等待存量任务并处理关闭超时

TaskTracker 的 wait() 只有在 tracker 已关闭且当前没有跟踪任务时才完成。一个容易误解的点是:close() 不会阻止之后继续 spawn();真正的“停止接收新工作”必须由应用自己的 accept 循环、队列入口或请求入口完成。

用 TaskTracker 等待存量任务

TaskTracker 位于 tokio_util::task,需要开启 tokio-util 的 rt feature。下面用两个已接收连接模拟关闭时的存量工作。

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

配置生效后,TaskTracker::spawn() 会把任务登记到 tracker;任务结束后会自动从跟踪状态中移除,不需要为了等待而长期保留每个 JoinHandle。

rust
use std::time::Duration;
use tokio::time::{sleep, timeout};
use tokio_util::task::TaskTracker;

async fn handle_connection(id: u8, work_ms: u64) {
    sleep(Duration::from_millis(work_ms)).await;
    println!("connection {id} finished");
}

#[tokio::main]
async fn main() {
    let tracker = TaskTracker::new();

    // 这些任务代表关闭信号到来前已经接收的连接。
    for (id, work_ms) in [(1_u8, 40_u64), (2_u8, 80_u64)] {
        tracker.spawn(handle_connection(id, work_ms));
    }

    // 真实服务应先让 accept 循环退出;这里用“不再 spawn”模拟停止接收。
    println!("stop accepting new work");
    tracker.close();

    // timeout 只限制等待时间,不会自动终止仍在运行的 tracked task。
    match timeout(Duration::from_millis(200), tracker.wait()).await {
        Ok(()) => println!("all tracked tasks finished"),
        Err(_) => println!("shutdown deadline exceeded"),
    }
}

预期输出

text
stop accepting new work
connection 1 finished
connection 2 finished
all tracked tasks finished

两个任务都在 200 毫秒截止时间内完成,因此 wait() 正常结束。如果把第二个任务的工作时间改到 200 毫秒以上,程序可能进入超时分支;这只表示“不再继续等”,并不等价于 TaskTracker 已经把任务强制终止。

close 不是拒绝新任务的开关

close() 的职责是改变 wait() 的完成条件,而不是封住任务入口。即使已经调用 close(),代码仍然可以再次通过同一个 tracker 生成任务,此时 wait() 会继续等到新任务也结束。

因此关闭顺序不能写反:先使 listener、channel receiver 或请求分发器停止产生新工作,再调用 close(),最后等待 tracker 归零。否则系统可能一边等待退出,一边又继续接收任务,导致关闭时间不可预测。

给优雅关闭设最终截止时间

最终截止时间应该覆盖所有存量任务的清理预算,而不是每个任务各自重新计时。timeout(deadline, tracker.wait()) 很适合限制总等待阶段,但超时后的动作需要应用显式定义。

如果任务支持协作式取消,可以在截止时间到达后再触发更强的取消信号;如果必须强制中止,则需要额外保存可中止句柄,或使用支持集中 abort 的任务集合。单独丢弃 TaskTracker 或让 wait() 超时都不会替你执行强制终止。

可靠的退出条件因此很明确:入口已经关闭、tracker 已关闭、存量任务在预算内归零;若最后一项未满足,就按照预先约定的升级策略处理,而不是无限等待。

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

目录与阅读设置

阅读设置

17

记录一个想法

等待任务有序退出

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

登录哪都通