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 的完整功能集加入依赖。为了让控制台输出稳定,示例只打印事件名称,不打印真实时间戳。
[package]
name = "tokio-time-demo"
version = "0.1.0"
edition = "2021"
[dependencies]
tokio = { version = "1", features = ["full"] }src/main.rs 同时演示一次延迟、三个周期节拍和一次必然超时。这里把错过节拍策略设为 Delay,避免任务长时间阻塞后立即补发一串历史节拍。
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"),
}
}在项目根目录执行:
cargo run --quiet预期输出
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。真正可靠的服务还要把取消语义和资源状态一起设计进去。