Rust / 系统课时

管理一组动态任务

管理一组动态任务

当任务数量在运行时才确定时,手工维护一串 JoinHandle 很快会变得笨重。JoinSet 把同一返回类型的任务集中到一个集合中,可以持续添加任务,并按完成顺序取回结果。本篇用一个动态任务列表演示添加、等待、错误处理与清理边界。

学习目标

  • 使用 JoinSet 动态添加同一返回类型的 Tokio 任务
  • 用 join_next 按完成顺序收集结果并处理 JoinError
  • 正确理解集合清空、提前取消和 Drop 时的任务清理行为

JoinSet 解决什么问题

JoinSet<T> 可以看成“带完成队列的任务集合”。调用 spawn 后,集合开始跟踪新任务;调用 join_next().await 时,会等待任意一个任务完成,返回 Option<Result<T, JoinError>>,并把这个已完成任务从集合中移除。

它与 Vec<JoinHandle<T>> 最大的使用差异是:你不必预先知道任务数量,也不必逐个决定先等待哪个句柄。JoinSet 返回的是完成顺序,而不是添加顺序,这很适合批量请求、动态工作队列和并发子任务。

集合中的所有任务必须返回同一种类型 T。如果不同任务天然产生不同结果,可以先统一成枚举或业务结果结构,再放入同一个 JoinSet。

动态添加并等待任务

示例项目使用 Tokio 的多线程运行时、宏和定时器。下面的配置足以运行本节代码。

toml
[package]
name = "joinset-demo"
version = "0.1.0"
edition = "2024"

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

生效行为:项目可以创建 JoinSet,并通过 Tokio 定时器模拟耗时不同的并发任务。验证时运行下面的 src/main.rs。

rust
use std::time::Duration;
use tokio::task::JoinSet;
use tokio::time::sleep;

#[tokio::main]
async fn main() {
    // 真实服务中,这个列表可以来自配置、请求拆分或运行时发现。
    let jobs = vec![("alpha", 90_u64), ("beta", 30), ("gamma", 60)];
    let mut set = JoinSet::new();

    for (name, delay_ms) in jobs {
        set.spawn(async move {
            sleep(Duration::from_millis(delay_ms)).await;
            format!("{name}:{delay_ms}")
        });
    }

    println!("running={}", set.len());

    while let Some(result) = set.join_next().await {
        match result {
            Ok(message) => {
                // join_next 已经移除刚完成的任务,因此 len 是剩余任务数。
                println!("done {message}; remaining={}", set.len());
            }
            Err(error) => eprintln!("task failed: {error}"),
        }
    }

    println!("empty={}", set.is_empty());
}

预期输出

text
running=3
done <RESULT>; remaining=2
done <RESULT>; remaining=1
done <RESULT>; remaining=0
empty=true

其中三个 <RESULT> 分别是 alpha:90、beta:30、gamma:60,每个只出现一次;实际顺序取决于任务何时真正完成,不能依赖添加顺序。每次 join_next 返回一个结果后,对应任务就从集合移除;当集合为空时,再次调用会返回 None,循环自然结束。

处理失败而不是直接 unwrap

任务主体返回 T,而 join_next 的外层 Result 反映 Tokio 任务本身是否正常结束。任务 panic 或被取消时,会得到 JoinError。因此服务代码通常像主示例那样显式匹配 Ok 与 Err,避免一个子任务失败就让结果收集逻辑整体 panic。

如果业务任务本身也可能失败,可以让任务返回 Result<Value, BusinessError>。此时会形成两层结果:外层表示“任务有没有正常完成”,内层表示“业务操作是否成功”。把这两类失败分开,日志和重试策略会更清楚。

提前结束时清理剩余任务

正常的 while let Some(...) 会一直取到集合为空。如果外层流程提前结束,不应忘记仍被集合跟踪的任务。JoinSet 被丢弃时会立即中止其中剩余任务,因此它比把大量句柄散落在多个容器里更容易管理生命周期。

需要主动关闭时,可以调用 set.shutdown().await:它会先中止全部剩余任务,再等待这些任务完成取消,并在返回时把集合清空。如果你需要逐个观察取消产生的 JoinError,则使用 abort_all() 发出取消请求,再继续用 join_next() 排空集合。

JoinSet 适合“数量动态、返回类型一致、希望按完成顺序处理”的任务组。若你只启动固定的两三个任务,并且必须按特定变量分别保留句柄,直接使用少量 JoinHandle 往往更简单;任务集合只有在生命周期和数量真正动态时才体现价值。

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

目录与阅读设置

阅读设置

17

记录一个想法

管理一组动态任务

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

登录哪都通