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)。

catch_unwind 隔离边界与两条返回路径

下面的示例故意保留两层结果:内层 Result 表示任务自己的可恢复错误,外层 Result 只表示隔离边界是否遇到 panic。为了让示例输出稳定,程序暂时关闭默认 panic hook;生产代码不应频繁修改这个进程级全局 hook。

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

预期输出:

text
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。

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

目录与阅读设置

阅读设置

17

记录一个想法

catch_unwind 的适用边界

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

登录哪都通