Rust / 系统课时
测试错误路径
测试错误路径
本课围绕失败场景编写测试:确认函数返回预期的 Result::Err,验证特定输入会触发 panic,并检查 panic 信息是否匹配关键文本,从而避免程序只在正常路径上看似正确。
学习目标
- 使用
unwrap_err和断言验证Result错误 - 使用
#[should_panic]声明预期 panic - 通过
expected限定 panic 信息,避免误判
为什么必须测试错误路径
正常输入测试只能证明“成功时能工作”,不能证明函数在非法输入、边界值或状态异常时会按约定失败。错误路径测试应验证错误类型或消息,而不是仅确认“出现了某种错误”。
对于可恢复错误,优先返回 Result;对于违反调用约定、程序无法继续维持不变量的情况,才考虑 panic。测试方式应与函数的错误模型一致。
同时验证 Result 与 panic
下面的 src/lib.rs 包含两个被测函数和三条测试,可直接运行。
pub fn parse_port(input: &str) -> Result<u16, String> {
let port = input
.parse::<u16>()
.map_err(|_| format!("无效端口: {input}"))?;
if port == 0 {
return Err("端口不能为 0".to_string());
}
Ok(port)
}
pub fn item_at(items: &[i32], index: usize) -> i32 {
// 越界属于调用方违反索引约定,直接触发 panic
items[index]
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn rejects_zero_port() {
let error = parse_port("0").unwrap_err();
assert_eq!(error, "端口不能为 0");
}
#[test]
fn rejects_non_numeric_port() {
let error = parse_port("abc").unwrap_err();
assert!(error.contains("无效端口"));
}
#[test]
#[should_panic(expected = "index out of bounds")]
fn panics_when_index_is_out_of_bounds() {
item_at(&[10, 20], 5);
}
}预期结果:
保存文件后不会立即产生控制台输出;执行后文的 cargo test 时,两条错误断言和一条预期 panic 测试应通过。unwrap_err() 要求结果必须是 Err,若函数意外返回 Ok,测试会立即失败。随后再对错误文本做精确或包含关系断言,可以确认错误原因正确。
#[should_panic] 只要求测试过程中出现 panic;增加 expected = "index out of bounds" 后,panic 信息还必须包含该文本,能防止测试因为无关 panic 而误通过。
运行并查看结果
在项目根目录执行:
cargo test预期输出:
running 3 tests
test tests::panics_when_index_is_out_of_bounds - should panic ... ok
test tests::rejects_non_numeric_port ... ok
test tests::rejects_zero_port ... ok
test result: ok. 3 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in <TIME>s测试显示顺序可能不同,但三条用例都应为 ok。其中预期 panic 的用例触发 panic 后仍显示通过,这是 #[should_panic] 的正常行为。
避免错误测试误通过
不要只写 assert!(parse_port("0").is_err()) 后就结束,因为它只能确认存在错误,无法确认错误原因。对于稳定的自定义错误,优先比较错误枚举;本例使用字符串,因此至少应验证完整消息或关键片段。
#[should_panic] 也不应滥用。若函数返回 Result,应直接断言 Err;只有被测契约本身规定会 panic 时,才使用预期 panic 测试。
本课总结
unwrap_err()能确保函数确实返回错误,并取得错误值继续断言#[should_panic(expected = "...")]可同时验证 panic 是否发生及其关键信息- 错误测试应验证具体原因,避免任何无关失败都被当作正确结果
下一课预告
下一课将继续整理 Rust 测试实践,关注测试组织、集成测试目录以及如何让测试代码保持可维护。