Rust / 系统课时

理解 Future 与 Poll

理解 Future 与 Poll

Rust 的异步代码不会因为创建了 Future 就自动向前执行。真正的推进发生在执行器调用 poll 时;当条件尚未满足,Future 返回 Pending 并借助 Waker 请求之后再次调度。本节用一个两次轮询即可完成的自定义 Future 把这条链路跑通。

学习目标

  • 理解 Future 的惰性:创建 Future 与执行其中逻辑是两件事。
  • 能解释 Poll::Pending、Poll::Ready 与 Waker 在执行器调度中的分工。
  • 能写出一个最小自定义 Future,并通过输出观察两次 poll 的状态变化。

Future 为什么是惰性的

调用 async fn 得到的是一个实现了 Future 的值,而不是已经执行完成的结果。Future 更像“尚待推进的计算状态”:只有执行器开始轮询它,函数体才会真正向前运行;单纯创建后放在变量里,不会主动启动后台工作。

await 也不是“阻塞直到结束”。它会让当前异步任务参与轮询目标 Future:如果目标返回 Ready(value),就继续向下执行;如果返回 Pending,当前任务暂停,把运行机会交回执行器。

Poll 与 Waker 如何形成循环

Future 的核心接口可以概括为:执行器拿到任务后调用 poll。如果当前状态足以产出结果,Future 返回 Poll::Ready(value);如果还要等待事件,就返回 Poll::Pending。但返回 Pending 之后,执行器不会无条件反复轮询,否则会造成忙等。

此时 Context 中的 Waker 提供了“以后再叫醒这个任务”的能力。I/O 驱动、定时器或 Future 自己保存必要的 Waker,在状态可能取得新进展时调用 wake,执行器再把任务放回可运行队列并重新 poll。

Future、Poll 与 Waker 的重新调度链路

这条链路的关键不是“Pending 等一会儿就会自己变成 Ready”,而是Future 必须保证在可能继续推进时触发对应 Waker。如果没有唤醒动作,任务可能永远停在 Pending;如果无条件频繁唤醒,又会浪费 CPU。

写一个只需两次 Poll 的 Future

下面的 TwoPoll 第一次被轮询时返回 Pending,同时调用当前任务的 Waker;执行器收到唤醒后再次轮询,它才返回 Ready。这是教学用最小模型,真实 I/O Future 通常会在外部事件到达时唤醒任务,而不是立即自唤醒。

Cargo.toml:

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

[dependencies]
tokio = { version = "1", features = ["macros", "rt"] }

src/main.rs:

rust
use std::future::Future;
use std::pin::Pin;
use std::task::{Context, Poll};

struct TwoPoll {
    polled_once: bool,
}

impl Future for TwoPoll {
    type Output = &'static str;

    fn poll(mut self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Self::Output> {
        if self.polled_once {
            println!("poll -> Ready");
            Poll::Ready("done")
        } else {
            // 第一次没有结果,但明确请求执行器之后再调度当前任务。
            self.polled_once = true;
            println!("poll -> Pending");
            cx.waker().wake_by_ref();
            Poll::Pending
        }
    }
}

#[tokio::main(flavor = "current_thread")]
async fn main() {
    let future = TwoPoll { polled_once: false };
    println!("future created");

    // 到 await 这里,Future 才交给执行器开始轮询。
    let result = future.await;
    println!("result = {result}");
}

预期输出

text
future created
poll -> Pending
poll -> Ready
result = done

future created 先出现,说明构造 Future 本身没有执行 poll。进入 .await 后第一次轮询得到 Pending;wake_by_ref 让当前任务重新进入可运行状态,第二次轮询才得到 Ready。执行器拿到 Ready 后会把这个 Future 视为完成,不再继续轮询。

Waker 的使用边界

真实 Future 返回 Pending 前,通常需要确保“负责完成这项工作的组件”持有最新的 Waker。例如套接字尚不可读时,由 I/O 驱动在可读事件到来后唤醒任务;定时器则在截止时间到达后唤醒任务。Waker 的职责只是通知“现在值得再 poll 一次”,并不直接携带 Future 的结果。

poll 本身应快速完成,不能为了等结果而长时间阻塞线程。自定义 Future 也不能把 Pending 当成普通循环条件持续自唤醒,否则会形成高 CPU 的忙轮询。正确模型是:能完成就 Ready,暂时不能完成就登记唤醒条件并 Pending,状态发生变化后再 wake。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 Future 与 Poll

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

登录哪都通