Rust / 系统课时

测试错误路径

测试错误路径

本课围绕失败场景编写测试:确认函数返回预期的 Result::Err,验证特定输入会触发 panic,并检查 panic 信息是否匹配关键文本,从而避免程序只在正常路径上看似正确。

学习目标

  • 使用 unwrap_err 和断言验证 Result 错误
  • 使用 #[should_panic] 声明预期 panic
  • 通过 expected 限定 panic 信息,避免误判

为什么必须测试错误路径

正常输入测试只能证明“成功时能工作”,不能证明函数在非法输入、边界值或状态异常时会按约定失败。错误路径测试应验证错误类型或消息,而不是仅确认“出现了某种错误”。

对于可恢复错误,优先返回 Result;对于违反调用约定、程序无法继续维持不变量的情况,才考虑 panic。测试方式应与函数的错误模型一致。

同时验证 Result 与 panic

下面的 src/lib.rs 包含两个被测函数和三条测试,可直接运行。

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

预期结果:

text
保存文件后不会立即产生控制台输出;执行后文的 cargo test 时,两条错误断言和一条预期 panic 测试应通过。

unwrap_err() 要求结果必须是 Err,若函数意外返回 Ok,测试会立即失败。随后再对错误文本做精确或包含关系断言,可以确认错误原因正确。

#[should_panic] 只要求测试过程中出现 panic;增加 expected = "index out of bounds" 后,panic 信息还必须包含该文本,能防止测试因为无关 panic 而误通过。

运行并查看结果

在项目根目录执行:

bash
cargo test

预期输出:

text
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 测试实践,关注测试组织、集成测试目录以及如何让测试代码保持可维护。

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

目录与阅读设置

阅读设置

17

记录一个想法

测试错误路径

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

登录哪都通