Rust / 系统课时
控制测试时间
控制测试时间
异步代码一旦依赖 sleep、超时或重试间隔,直接等待真实时间会让测试变慢,还容易受机器负载影响。本节用 Tokio 的暂停时钟和虚拟时间推进,把“等几秒”变成可控、可重复的测试步骤。
学习目标
- 使用
start_paused或time::pause冻结 Tokio 测试时钟 - 使用
time::advance精确推进定时器并验证任务状态 - 识别虚拟时间的自动推进和运行时限制,避免写出偶发失败的测试
为什么要冻结时间
假设业务逻辑要在 5 秒后执行一次动作。测试里真的 sleep(Duration::from_secs(5)),每个用例都会消耗至少 5 秒;超时、退避重试一多,测试套件很快就会被真实等待拖慢。
Tokio 的测试时间工具会冻结 Tokio 自己的 Instant 和基于它的定时器。测试可以把虚拟时钟直接推进到未来,让 sleep、timeout 等计时逻辑立即达到截止点,而不是等待墙上时钟流逝。
启用测试时间工具
在 Cargo.toml 中启用宏、运行时、时间和测试工具特性。下面是本节示例所需的最小依赖片段。
[dependencies]
tokio = { version = "1", features = ["macros", "rt", "time", "test-util"] }这是配置片段,不单独产生控制台输出。test-util 提供 pause、advance 等测试时间 API;#[tokio::test] 默认使用当前线程运行时,适合暂停时钟。
用 start_paused 驱动定时器
如果整个测试从一开始就要使用虚拟时间,优先在测试宏上写 start_paused = true。下面的任务会等待 5 秒后返回,但测试不会真实等待 5 秒。
use tokio::time::{self, Duration};
async fn delayed_value() -> &'static str {
time::sleep(Duration::from_secs(5)).await;
"ready"
}
#[tokio::test(start_paused = true)]
async fn completes_after_virtual_time() {
let task = tokio::spawn(delayed_value());
// 先让新任务被轮询一次,确保 5 秒定时器已经注册。
tokio::task::yield_now().await;
assert!(!task.is_finished());
time::advance(Duration::from_secs(5)).await;
// advance 只推进时钟,再让运行时轮询已到期的任务。
tokio::task::yield_now().await;
assert_eq!(task.await.unwrap(), "ready");
println!("virtual timer completed");
}预期输出
virtual timer completed测试中的 5 秒是虚拟时间,正常情况下墙上时钟只经过很短时间。若不使用 start_paused,也可以在当前线程 Tokio 运行时内调用 time::pause();两种方式不要在同一个已经冻结的时钟上重复暂停。

处理自动推进和边界
暂停时间后,如果运行时没有其他可执行工作,Tokio 可能自动把虚拟时钟推进到下一个定时器。因此,单纯 sleep(...).await 的测试有时不需要显式 advance。需要验证“推进前尚未完成、推进后才完成”这类中间状态时,显式控制更容易表达意图。
advance 会把时钟直接跳过指定时长,但它不会保证被跨过的所有定时器对应任务已经完成,所以示例在推进后再次 yield_now().await。如果测试只关心最终超时结果,而不关心中间状态,让暂停时钟配合 sleep 自动推进通常更简单。
控制时间的核心不是“让 sleep 更快”,而是把时间变成测试输入:先安排定时器,再明确推进到某个时间点,最后检查任务是否按预期进入下一状态。