Rust / 系统课时

控制测试时间

控制测试时间

异步代码一旦依赖 sleep、超时或重试间隔,直接等待真实时间会让测试变慢,还容易受机器负载影响。本节用 Tokio 的暂停时钟和虚拟时间推进,把“等几秒”变成可控、可重复的测试步骤。

学习目标

  • 使用 start_paused 或 time::pause 冻结 Tokio 测试时钟
  • 使用 time::advance 精确推进定时器并验证任务状态
  • 识别虚拟时间的自动推进和运行时限制,避免写出偶发失败的测试

为什么要冻结时间

假设业务逻辑要在 5 秒后执行一次动作。测试里真的 sleep(Duration::from_secs(5)),每个用例都会消耗至少 5 秒;超时、退避重试一多,测试套件很快就会被真实等待拖慢。

Tokio 的测试时间工具会冻结 Tokio 自己的 Instant 和基于它的定时器。测试可以把虚拟时钟直接推进到未来,让 sleep、timeout 等计时逻辑立即达到截止点,而不是等待墙上时钟流逝。

启用测试时间工具

在 Cargo.toml 中启用宏、运行时、时间和测试工具特性。下面是本节示例所需的最小依赖片段。

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 秒。

rust
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");
}

预期输出

text
virtual timer completed

测试中的 5 秒是虚拟时间,正常情况下墙上时钟只经过很短时间。若不使用 start_paused,也可以在当前线程 Tokio 运行时内调用 time::pause();两种方式不要在同一个已经冻结的时钟上重复暂停。

虚拟时间推进与定时器触发过程

处理自动推进和边界

暂停时间后,如果运行时没有其他可执行工作,Tokio 可能自动把虚拟时钟推进到下一个定时器。因此,单纯 sleep(...).await 的测试有时不需要显式 advance。需要验证“推进前尚未完成、推进后才完成”这类中间状态时,显式控制更容易表达意图。

advance 会把时钟直接跳过指定时长,但它不会保证被跨过的所有定时器对应任务已经完成,所以示例在推进后再次 yield_now().await。如果测试只关心最终超时结果,而不关心中间状态,让暂停时钟配合 sleep 自动推进通常更简单。

控制时间的核心不是“让 sleep 更快”,而是把时间变成测试输入:先安排定时器,再明确推进到某个时间点,最后检查任务是否按预期进入下一状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

控制测试时间

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

登录哪都通