Rust / 系统课时

创建任务并等待结果

创建任务并等待结果

tokio::spawn 会把 Future 交给 Runtime 独立调度,并立即返回 JoinHandle。真正需要掌握的是句柄之后的生命周期:正常完成怎样取值、abort 后怎样确认取消、任务 panic 又怎样与业务错误区分。

学习目标

  • 使用 tokio::spawn 创建任务,并通过 JoinHandle::await 获取任务结果。
  • 区分正常完成、主动取消和 panic 导致的任务失败。
  • 正确理解 abort、丢弃 JoinHandle 与 spawn_blocking 的取消边界。

JoinHandle 是观察任务结果的句柄

tokio::spawn(future) 会把任务提交给当前 Runtime,任务随后可以与调用者并发推进;调用者不需要先 await 这个句柄,任务才开始执行。返回的 JoinHandle<T> 表示“以后等待这个任务终止并取得结果”的能力。

等待句柄时得到的不是直接的 T,而是 Result<T, JoinError>。Ok(T) 表示任务正常结束;Err(JoinError) 表示任务没有正常返回,常见原因是被取消或发生 panic。

如果任务本身返回 Result<T, E>,那么句柄等待结果会形成两层 Result:外层描述 Tokio 任务是否正常终止,内层才描述业务操作成功还是失败。排错时不要把这两层错误混在一起。

tokio 任务与 JoinHandle 生命周期

用一个程序观察三种终止方式

这个示例同时创建正常完成、主动取消和 panic 三类任务。为了让终端输出稳定,示例临时关闭默认 panic hook;生产程序通常不应为了“安静”而全局屏蔽 panic 日志。

Cargo.toml:

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

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

src/main.rs:

rust
use std::time::Duration;

#[tokio::main]
async fn main() {
    let completed = tokio::spawn(async { 21 * 2 });
    let value = completed.await.expect("completed task should not fail");
    println!("completed: {value}");

    let cancelled = tokio::spawn(async {
        tokio::time::sleep(Duration::from_secs(60)).await;
        99
    });
    cancelled.abort(); // 只发出取消请求,await 才等待取消真正完成
    let cancel_error = cancelled.await.expect_err("task should be cancelled");
    println!("cancelled: {}", cancel_error.is_cancelled());

    // 仅为让教学示例输出稳定,临时替换并随后恢复默认 panic hook。
    let original_hook = std::panic::take_hook();
    std::panic::set_hook(Box::new(|_| {}));
    let panicked = tokio::spawn(async {
        panic!("boom");
    });
    let panic_error = panicked.await.expect_err("task should panic");
    std::panic::set_hook(original_hook);
    println!("panicked: {}", panic_error.is_panic());
}

预期结果:保存上述文件后执行 cargo run --quiet,应看到:

text
completed: 42
cancelled: true
panicked: true

第一项说明任务正常返回值被 await 取得;第二项说明取消最终体现在 JoinError::is_cancelled();第三项说明 panic 不会变成任务返回值,而是由外层 JoinError 报告。

abort 不是同步停止按钮

JoinHandle::abort() 会请求取消异步任务,但方法本身不会等待清理完成。任务通常会在下一次让出执行权的位置停止,局部变量随后被销毁;如果你需要确认任务已经结束,应继续 await 原来的 JoinHandle。

取消存在竞态:若任务在取消请求生效前已经正常完成,await 仍可能得到 Ok(T)。因此业务代码不要把“调用过 abort”等同于“任务一定以 cancelled 结束”。

任务失败与业务失败要分层处理

对于会返回业务错误的任务,常见类型是 JoinHandle<Result<T, E>>。处理顺序应该先判断外层任务状态,再处理内层业务结果:外层 panic 或取消意味着任务没有按函数契约返回;只有外层为 Ok 时,内层错误才是正常业务路径的一部分。

tokio::spawn 还要求被提交的 Future 及其输出满足可跨线程调度所需的 Send + 'static 约束。需要运行 !Send Future 时,应使用本地任务机制,而不是靠切换成 current_thread 后继续调用普通 spawn。

最后要特别区分 tokio::spawn 与 spawn_blocking:异步任务可以通过 abort 请求取消,而已经开始执行的 spawn_blocking 闭包通常不能被 abort 强行停止。对阻塞任务应设计自己的停止信号、超时和资源回收策略。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建任务并等待结果

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

登录哪都通