Rust / 系统课时

使用睡眠、间隔与超时

使用睡眠、间隔与超时

异步服务经常同时需要“稍后再做”“按节拍重复做”和“等到截止时间就放弃等待”。本节用 Tokio 的 sleep、interval 与 timeout 建立一套可运行的时间控制方式,并重点说明超时发生后任务与外部资源并不会自动回滚。

学习目标

  • 使用 sleep、interval 和 timeout 分别实现延迟、周期执行与单次超时。
  • 识别 interval 首次立即触发和错过节拍时的行为。
  • 判断超时取消后哪些状态已经生效,避免把“停止等待”误解为“撤销操作”。

三种时间工具的边界

sleep(duration).await 让当前异步任务暂停到期限到达,期间不会占住执行器线程做忙等。interval(period) 适合长期周期任务;它维护下一次节拍,而不是简单地在每轮工作结束后再睡固定时长。timeout(limit, future) 则给一个 Future 加截止时间,成功时返回内部结果,超时时返回 Err(Elapsed)。

工具 解决的问题 关键边界
sleep 一次延迟 只控制当前等待点
interval 周期节拍 第一次 tick() 默认立即完成
timeout 单次截止时间 超时会停止内部 Future 的继续执行,但不会撤销已产生的副作用

Tokio 三种时间控制工具的时间线关系

搭建可运行示例

新建一个二进制项目,并把 Tokio 的完整功能集加入依赖。为了让控制台输出稳定,示例只打印事件名称,不打印真实时间戳。

toml
[package]
name = "tokio-time-demo"
version = "0.1.0"
edition = "2021"

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

src/main.rs 同时演示一次延迟、三个周期节拍和一次必然超时。这里把错过节拍策略设为 Delay,避免任务长时间阻塞后立即补发一串历史节拍。

rust
use tokio::time::{
    interval, sleep, timeout, Duration, MissedTickBehavior,
};

#[tokio::main]
async fn main() {
    println!("delay:start");
    // sleep 只挂起当前异步任务,不用线程忙等计时。
    sleep(Duration::from_millis(50)).await;
    println!("delay:done");

    let mut ticker = interval(Duration::from_millis(40));
    ticker.set_missed_tick_behavior(MissedTickBehavior::Delay);

    for i in 1..=3 {
        ticker.tick().await;
        println!("tick:{i}");
    }

    // 内部任务故意比 80 ms 的截止时间慢,用于稳定触发超时分支。
    let slow_job = async {
        sleep(Duration::from_millis(200)).await;
        "finished"
    };

    match timeout(Duration::from_millis(80), slow_job).await {
        Ok(value) => println!("timeout:{value}"),
        Err(_) => println!("timeout:elapsed"),
    }
}

在项目根目录执行:

bash
cargo run --quiet

预期输出

text
delay:start
delay:done
tick:1
tick:2
tick:3
timeout:elapsed

理解 interval 的节拍

interval 的第一次 tick().await 默认立即就绪,所以示例中的 tick:1 不会先等待 40 毫秒。如果业务要求“先完整等待一个周期再执行第一次任务”,可以用 interval_at 把首个截止时间设到未来,或者在进入周期循环前先做一次明确的延迟。

当某一轮工作耗时超过周期时,还要决定怎样处理错过的节拍。默认策略会尝试追赶;MissedTickBehavior::Delay 则从重新获得执行机会的时刻向后延迟下一个节拍。监控采样、轮询这类任务通常应明确选择策略,而不是依赖默认值。

超时后资源发生了什么

timeout 超时时会停止继续轮询并丢弃它包裹的 Future。这个动作取消的是尚未完成的异步计算,不是数据库事务回滚、文件截断或网络协议补偿。若 Future 在超时前已经发出一部分请求、写入一部分数据或更新了共享状态,那些副作用仍然存在。

因此,超时后的正确处理顺序是先确认操作的取消语义,再决定能否重试。对可能发生部分写入的操作,应使用幂等键、协议序号或显式状态机避免整段重放造成重复。另一个边界是:如果内部 Future 长时间不让出执行权,超时检查也无法及时发生,所以 CPU 密集工作应主动切分或交给阻塞任务线程池。

选择工具时可以按一个简单原则:一次等待用 sleep,稳定节拍用 interval,给单个异步操作设上限用 timeout。真正可靠的服务还要把取消语义和资源状态一起设计进去。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用睡眠、间隔与超时

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

登录哪都通