Rust / 系统课时

断言与 unreachable 的边界

断言与 unreachable 的边界

断言和 unreachable! 都是在运行时维护程序内部约束:前者验证“这里必须成立”,后者声明“这里按设计不可能到达”。它们适合暴露程序错误,不适合把可预期的输入失败伪装成崩溃。

学习目标

  • 区分 assert!、debug_assert! 与 unreachable! 的职责
  • 判断何时应使用断言,何时应返回 Result
  • 理解错误使用这些宏会怎样导致 panic

断言表达的是内部不变量

assert! 在条件为 false 时触发 panic,debug 与 release 构建都会保留。assert_eq!、assert_ne! 只是把常见比较写得更清楚,并在失败时提供两侧值。

它们最适合检查调用者和当前模块已经约定好的内部条件。例如某段代码只允许处理 HTTP 状态码范围,那么进入分类逻辑前可以断言范围已经合法。

rust
fn classify_status(status: u16) -> &'static str {
    // 这是内部前置条件:调用此函数前应保证状态码处于协议范围。
    assert!(
        (100..=599).contains(&status),
        "invalid HTTP status: {status}"
    );

    match status {
        100..=199 => "informational",
        200..=299 => "success",
        300..=399 => "redirection",
        400..=499 => "client-error",
        500..=599 => "server-error",
        _ => unreachable!("status range was checked before matching"),
    }
}

fn main() {
    println!("{}", classify_status(200));
    println!("{}", classify_status(404));
}

预期输出:

text
success
client-error

如果把 700 传给 classify_status,前面的断言会 panic,因此后面的 _ 分支仍然代表“在已验证约束成立时不可能出现”的情况。

debug_assert 只适合开发期检查

debug_assert! 与 assert! 的语义相似,但通常只在启用 debug_assertions 时执行;Cargo 默认的 debug 构建会启用它,而常见的 release 构建不会。

因此,不能依赖 debug_assert! 保证生产环境安全性或数据正确性。它更适合检查代价较高、但违反后明确说明程序内部存在 bug 的条件。只要条件关系到业务正确性、权限、金额或外部输入,就应使用正常分支处理。

unreachable 声明逻辑上不可能的分支

unreachable! 本质上仍会 panic。它不会让错误输入自动变成“安全不可达”,而是把一个设计假设写进代码:只要前面的约束成立,这个分支就不会执行。

常见场景是穷尽匹配前已经完成更窄范围的验证,或者某个状态机在当前函数入口处已被限定到一组状态。若这个假设后来因重构失效,unreachable! 会把问题迅速暴露出来。

标准库还有不安全的 std::hint::unreachable_unchecked。它与 unreachable! 不同:一旦实际执行到该位置会产生未定义行为,而不是可靠地 panic。除非能严格证明分支永远不可达,否则不要使用它。

Result 与断言怎么选

判断标准不是“这个错误严重不严重”,而是失败是否属于程序正常运行时可预期的情况。

情况 合适表达
用户输入格式错误、文件不存在、网络失败 Result 或 Option
模块内部必须始终成立的不变量 assert! / assert_eq!
仅希望开发期发现昂贵的一致性检查 debug_assert!
在已验证约束下逻辑上不可能到达的分支 unreachable!

断言的价值在于让“程序员错误”尽早暴露;Result 的价值在于让“运行时可恢复失败”继续沿正常控制流处理。两者边界清楚,panic 才不会被误用成普通错误通道。

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

目录与阅读设置

阅读设置

17

记录一个想法

断言与 unreachable 的边界

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

登录哪都通