Rust / 系统课时
哪些失败应该直接 panic
哪些失败应该直接 panic
panic! 不是普通错误返回方式,而是声明“当前执行路径已经失去可信前提,不能再按正常逻辑继续”。判断是否该 panic,关键不是错误有多严重,而是失败是否代表内部不变量被破坏、程序存在缺陷,或继续执行会制造更大的错误。
学习目标
- 区分可恢复失败与应直接终止当前执行路径的失败
- 用“不变量、程序缺陷、能否继续”三个问题判断 panic 是否合理
- 避免把用户输入、网络波动等正常运行风险错误地升级为崩溃
panic 适合表达什么
Rust 的 Result 表示调用方可以面对并处理的失败;panic! 更适合表达“按程序设计这里本不应该失败”。常见判断可以归为三类。
第一类是不变量已经被破坏。例如某个内部结构要求 used <= capacity,但运行到关键逻辑时发现 used > capacity。这通常说明前面的实现出现了缺陷,继续计算得到的结果已经不可信。
第二类是程序自身的固定内容有错误。例如源代码里写死的常量或固定地址无法解析。它不是运行环境造成的偶发失败,而是开发阶段就应该被发现并修复的问题。
第三类是失败后没有合理的继续路径。如果继续运行只会传播错误状态、产生错误数据或破坏更重要的不变量,那么立即停止当前执行路径通常比伪装成成功更安全。
用不变量判断 panic
下面的例子模拟一个内部状态对象。used 大于 capacity 按设计永远不应发生;一旦发现这种状态,继续计算剩余容量已经没有意义,因此直接 panic。
#[derive(Debug)]
struct BufferState {
capacity: usize,
used: usize,
}
impl BufferState {
fn remaining(&self) -> usize {
if self.used > self.capacity {
panic!(
"internal invariant broken: used ({}) > capacity ({})",
self.used, self.capacity
);
}
self.capacity - self.used
}
}
fn main() {
let state = BufferState {
capacity: 8,
used: 10,
};
println!("remaining = {}", state.remaining());
}预期输出
thread 'main' panicked at <PATH>:<LINE>:
internal invariant broken: used (10) > capacity (8)实际文件路径、行号以及 panic 附带的运行时信息可能不同,但程序会在计算错误结果之前终止当前执行路径。
这里真正支持 panic 的不是“容量不足很严重”,而是 used > capacity 违反了这个类型内部承诺的关系。如果这个值来自用户提交的参数,而且业务允许用户输错,那么边界层应先验证并返回错误,而不应把用户输入变成 panic。
哪些失败通常不该 panic
生产程序会持续遇到大量“预期中的失败”:文件不存在、请求超时、数据库暂时不可用、用户输入格式错误、权限不足。这些情况即使影响当前操作,也不代表程序本身已经失去可信状态。
可以用三个问题快速判断:
| 判断问题 | 更倾向 panic | 更倾向 Result |
|---|---|---|
| 失败是否意味着代码违反自身约定 | 是 | 否 |
| 调用方是否有合理恢复动作 | 没有 | 有 |
| 同类失败是否会在正常运行中出现 | 理论上不应出现 | 本来就可能出现 |
例如读取配置文件失败通常应返回 Result,因为文件可能被删除、权限可能变化、路径可能配置错误。相反,如果编译进程序的固定字面量无法解析,往往更接近开发缺陷。
把 panic 留在正确边界
应用代码还要考虑 panic 的影响范围。在线服务中,一个请求触发的可恢复错误不应让整个进程退出;库代码也不应因为普通参数错误随意 panic,否则调用方无法决定恢复策略。
因此,判断 panic 的核心不是“这个错误够不够严重”,而是“继续执行是否仍然可信”。可恢复失败交给类型系统和调用方处理;程序缺陷与被破坏的不变量,则应尽早暴露,而不是把错误状态继续传下去。