Rust / 系统课时
catch_unwind 的适用边界
catch_unwind 的适用边界
catch_unwind 能在特定边界捕获“通过栈展开传播的 panic”,让宿主代码决定是否继续工作。它适合隔离插件、任务或回调中的程序错误,但不能替代 Result,也不能保证捕获所有形式的进程终止。
学习目标
- 理解
catch_unwind返回值与 panic 栈展开的关系 - 知道哪些 panic 能捕获、哪些不能
- 把
catch_unwind放在隔离边界,而不是普通业务错误路径中
catch_unwind 捕获的是栈展开
std::panic::catch_unwind 接收一个闭包。闭包正常返回时得到 Ok(value);闭包发生可展开的 panic 时,栈开始 unwinding,catch_unwind 在边界处把 panic 变成 Err(payload)。

下面的示例故意保留两层结果:内层 Result 表示任务自己的可恢复错误,外层 Result 只表示隔离边界是否遇到 panic。为了让示例输出稳定,程序暂时关闭默认 panic hook;生产代码不应频繁修改这个进程级全局 hook。
use std::panic;
fn process_job(input: &str) -> Result<usize, &'static str> {
if input.is_empty() {
return Err("input is empty");
}
if input == "panic" {
panic!("simulated bug");
}
Ok(input.len())
}
fn run_isolated(
input: &str,
) -> Result<Result<usize, &'static str>, &'static str> {
// 只把 panic 转成隔离边界错误,不改写任务自己的 Result。
match panic::catch_unwind(|| process_job(input)) {
Ok(result) => Ok(result),
Err(_) => Err("panic crossed isolation boundary"),
}
}
fn main() {
let previous_hook = panic::take_hook();
panic::set_hook(Box::new(|_| {}));
println!("{:?}", run_isolated("rust"));
println!("{:?}", run_isolated(""));
println!("{:?}", run_isolated("panic"));
panic::set_hook(previous_hook);
}预期输出:
Ok(Ok(4))
Ok(Err("input is empty"))
Err("panic crossed isolation boundary")第一行是正常成功;第二行说明普通错误仍由任务自己的 Result 表达;第三行才是 catch_unwind 捕获到 panic 后形成的边界错误。
它有明确的捕获限制
catch_unwind 只对“unwind”策略下的 Rust panic 有效。如果程序或相关构建配置采用 panic=abort,panic 会直接终止进程,无法在这里变成 Err。
闭包还必须满足 UnwindSafe。这个约束不是“捕获后一定安全”的证明,而是帮助避免在栈展开中跨越可能处于不一致状态的可变数据。确实理解风险时可以使用 AssertUnwindSafe,但它相当于由开发者主动承担这项判断,不应作为消除编译错误的惯用手段。
默认 panic hook 会在栈展开前执行,所以即使 panic 最终被 catch_unwind 捕获,日志或终端仍可能先看到 panic 信息。示例里静默 hook 只是为了得到稳定演示输出。
适合放在系统隔离边界
catch_unwind 的价值通常出现在“某一段不可信内部代码失败,但宿主还希望做清理、记录或继续服务”的位置,例如任务执行器的单任务边界、插件宿主调用插件的边界,或需要阻止 Rust panic 越过特定外部接口的封装层。
即便捕获成功,也不能假设当前任务留下的所有共享状态都仍然可用。是否继续复用对象、锁、缓存或事务,要由具体设计决定;必要时宁可丢弃该任务上下文并重新初始化。
何时不要使用
如果你发现普通函数层层包着 catch_unwind,再把 Err(payload) 转成业务错误,通常说明边界放错了。正常错误应在类型系统里表达,panic 应保留给不可恢复的程序缺陷,而 catch_unwind 只在确实需要“隔离一个可能 panic 的执行单元”时使用。
把这三条路径分开后,工程边界会更清晰:业务失败走 Result,程序缺陷触发 panic,只有宿主级隔离层才考虑 catch_unwind。