Rust / 系统课时

为错误类型建立回归测试

为错误类型建立回归测试

错误测试的价值不只是确认“这里返回了 Err”,而是把错误分类、稳定消息和必要上下文固定成可回归的行为契约。这样一旦重构错误处理链路,就能及时发现调用方真正依赖的异常语义被意外改变。

学习目标

  • 能测试 Rust 错误类型的分类与分支行为。
  • 能判断错误消息中哪些内容值得长期固定。
  • 能通过测试保护错误上下文,同时避免把动态信息写死。

先测试错误分类

如果调用方会根据错误类型决定重试、提示用户还是直接终止,那么错误枚举本身就是重要契约。测试应优先判断具体变体,而不是只判断 is_err()。

下面用自定义错误类型演示一个常见的配置读取场景:

rust
#[derive(Debug, PartialEq)]
enum ConfigError {
    Missing(&'static str),
    InvalidPort(String),
}

fn parse_port(value: Option<&str>) -> Result<u16, ConfigError> {
    let raw = value.ok_or(ConfigError::Missing("PORT"))?;
    raw.parse::<u16>()
        .map_err(|_| ConfigError::InvalidPort(raw.to_string()))
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn missing_port_returns_missing_error() {
        let result = parse_port(None);

        assert_eq!(result, Err(ConfigError::Missing("PORT")));
    }

    #[test]
    fn invalid_port_preserves_input_as_context() {
        let result = parse_port(Some("abc"));

        assert_eq!(
            result,
            Err(ConfigError::InvalidPort("abc".to_string()))
        );
    }
}

预期输出

text
running 2 tests
test tests::invalid_port_preserves_input_as_context ... ok
test tests::missing_port_returns_missing_error ... ok

这两个测试分别保护“缺失”和“格式非法”两种不同语义。以后即使内部改成其他解析库,只要错误契约保持不变,测试就无需跟着实现细节变化。

决定哪些错误消息值得断言

消息可以帮助排查问题,但并不是所有消息文本都适合成为严格契约。面向用户或日志采集系统、且已经约定格式的消息,可以完整断言;包含文件路径、请求 ID、时间戳等动态信息时,更适合拆成稳定片段与动态上下文。

例如测试错误展示文本时,可以把核心部分固定下来:

rust
fn describe_error(error: &ConfigError) -> String {
    match error {
        ConfigError::Missing(name) => format!("missing configuration: {name}"),
        ConfigError::InvalidPort(value) => format!("invalid PORT value: {value}"),
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn error_message_contains_stable_category_and_context() {
        let message = describe_error(&ConfigError::InvalidPort("abc".to_string()));

        assert!(message.contains("invalid PORT value"));
        assert!(message.contains("abc"));
    }
}

预期输出

text
running 1 test
test tests::error_message_contains_stable_category_and_context ... ok

这种写法适合消息是给人阅读、但未来可能调整措辞的场景。若消息已经被外部系统按完整字符串解析,则应把完整格式视为接口契约,并改为完整相等断言。

为错误上下文建立边界

错误上下文的测试要回答一个实际问题:发生故障时,调用方是否得到足够的信息继续处理?常见稳定信息包括配置项名称、资源 ID、操作类型和原始输入的必要摘要。

不要为了“更多覆盖率”把随机值、完整堆栈、时间戳等全部写进断言。更稳妥的做法是验证结构化错误是否保留关键上下文,再让其他动态字段保持自由。

用回归测试锁住异常行为

错误测试最适合保护容易在重构中悄悄改变的边界:错误变体被合并、消息丢失上下文、底层错误被错误地吞掉,或者同一种失败被映射到错误分类。

可以把一条回归测试写成明确契约:给定输入,得到指定错误类型,并保留指定的稳定上下文。这样测试既能验证异常路径,又不会要求未来的实现继续保留当前的内部错误传播方式。

最终判断标准很简单:测试保护的应该是调用方能够观察并依赖的错误语义,而不是当前实现恰好如何构造这个错误。

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

目录与阅读设置

阅读设置

17

记录一个想法

为错误类型建立回归测试

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

登录哪都通