Rust / 系统课时
处理测试输出与失败现场
处理测试输出与失败现场
测试失败时,真正需要的不是一句“failed”,而是失败测试的名称、断言差异和现场输出。本文通过成功、失败、忽略三种结果状态,以及标准输出捕获规则,建立一套从结果到根因的定位方法。
学习目标
- 区分通过、失败和忽略测试在测试报告中的含义
- 会读取断言失败中的期望值、实际值与测试名称
- 掌握
--nocapture,在需要时保留更完整的运行现场
先看测试结果状态
Rust 测试程序最常见的三种状态是 ok、FAILED 和 ignored。ok 表示测试执行并通过;FAILED 表示执行后断言或代码发生失败;ignored 表示测试存在,但本次运行没有执行它。
一个最小示例:
#[cfg(test)]
mod tests {
#[test]
fn success_case() {
assert_eq!(2 + 2, 4);
}
#[test]
fn failure_case() {
assert_eq!(2 + 2, 5);
}
#[test]
#[ignore]
fn ignored_case() {
assert!(false);
}
}预期结果
success_case ... ok
failure_case ... FAILED
ignored_case ... ignored
最终汇总中会分别出现 passed、failed 和 ignored 的数量。因此看到 ignored 时,不要把它理解成“测试通过了”,它只是说明该测试没有参加这次运行。
从失败现场读取根因
默认情况下,测试线程的标准输出通常会被测试框架捕获;当测试失败时,相关输出可以出现在失败报告中。断言失败本身也会给出左值与右值,这是定位错误业务数据时最直接的证据。
例如运行失败测试:
cargo test failure_case预期输出
running 1 test
test tests::failure_case ... FAILED
---- tests::failure_case stdout ----
thread 'tests::failure_case' panicked at src/lib.rs:<LINE>:<COLUMN>:
assertion `left == right` failed
left: 4
right: 5
failures:
tests::failure_case
test result: FAILED. 0 passed; 1 failed; 0 ignored其中 <LINE> 和 <COLUMN> 会随源码位置变化。排查时优先确认三个信息:失败的是哪个测试、实际值是什么、期望值是什么。如果断言前有关键业务日志,再结合这些日志判断是哪一步把状态带偏。
用 --nocapture 保留运行输出
当需要观察测试执行期间的标准输出,尤其是测试本身会打印请求参数、状态变化或诊断信息时,可以使用测试二进制参数 --nocapture。
#[cfg(test)]
mod tests {
#[test]
fn print_debug_context() {
println!("building test fixture");
println!("checking value: {}", 42);
assert_eq!(42, 42);
}
}预期结果
代码包含一个通过测试,并在执行过程中写出两条诊断信息。运行时写成:
cargo test print_debug_context -- --nocapture预期输出
running 1 test
building test fixture
checking value: 42
test tests::print_debug_context ... ok
test result: ok. 1 passed; 0 failed; 0 ignored这里的两个 -- 很重要:前一个参数属于 Cargo,后面的 --nocapture 属于 Rust 测试程序。把它写成 cargo test --nocapture 会把参数放错层级。
把失败现场变成可复现线索
一次失败后,不要只复制最后一行 test result: FAILED。至少保留失败测试名、断言信息以及必要的标准输出;随后可以先单独运行该测试,再配合 --nocapture 缩小现场。若失败只在并发执行时出现,还可以继续使用 --test-threads=1 验证是否存在共享状态或执行顺序依赖。
当输出中已经明确给出“实际值与期望值不一致”时,应先检查产生实际值的代码,而不是反复重跑测试。测试输出的价值就在于把一次失败转换成下一步可验证的排查假设。