Rust / 系统课时
等待任务有序退出
等待任务有序退出
停止接收新工作后,服务还要回答另一个问题:已经接收的任务什么时候才算真正结束。本节使用 TaskTracker 跟踪存量任务,并用最终关闭截止时间限制等待过程,避免优雅关闭无限期挂住。
学习目标
- 使用
TaskTracker跟踪并等待已启动任务退出 - 正确理解
close()、停止接收新工作与wait()的关系 - 用
tokio::time::timeout为最终关闭设置截止时间
把关闭拆成三个阶段
有序关闭通常按“停止接收 → 等待存量 → 超时升级”推进。先让监听循环不再创建新连接或新请求,再关闭 tracker 的等待窗口,最后等待当前任务归零;如果超过总截止时间,则进入日志告警、强制取消或进程退出等升级策略。

TaskTracker 的 wait() 只有在 tracker 已关闭且当前没有跟踪任务时才完成。一个容易误解的点是:close() 不会阻止之后继续 spawn();真正的“停止接收新工作”必须由应用自己的 accept 循环、队列入口或请求入口完成。
用 TaskTracker 等待存量任务
TaskTracker 位于 tokio_util::task,需要开启 tokio-util 的 rt feature。下面用两个已接收连接模拟关闭时的存量工作。
[dependencies]
tokio = { version = "1", features = ["macros", "rt-multi-thread", "time"] }
tokio-util = { version = "0.7.19", features = ["rt"] }配置生效后,TaskTracker::spawn() 会把任务登记到 tracker;任务结束后会自动从跟踪状态中移除,不需要为了等待而长期保留每个 JoinHandle。
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"),
}
}预期输出
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 已关闭、存量任务在预算内归零;若最后一项未满足,就按照预先约定的升级策略处理,而不是无限等待。