Rust / 系统课时

传播错误

传播错误

当函数无法自行恢复时,最合适的做法通常不是立即打印或终止程序,而是把错误交给调用者处理。本课通过一个可运行示例说明 ? 如何提前返回错误、如何保留成功值,以及错误类型为何必须能够转换。

学习目标

  • 理解 ? 对 Result 的提前返回行为
  • 使用 ? 简化多层调用中的错误传播
  • 判断返回类型是否满足错误转换要求

问号运算符做了什么

对 Result<T, E> 使用 ? 时,成功分支会取出其中的 T 并继续执行;失败分支会立即结束当前函数,把错误返回给调用者。因此,? 只能出现在返回类型允许传播该错误的函数或闭包中。

它并不是简单地把原始错误原样返回。当前表达式的错误类型为 E1,函数声明的错误类型为 E2 时,编译器会尝试通过 From<E1> for E2 完成转换。无法转换时,代码会在编译阶段失败。

完整示例:读取并解析端口

下面的程序先写入一个临时配置文件,再读取其中的端口号。文件读取可能产生 std::io::Error,字符串解析可能产生 ParseIntError,二者都通过 ? 传播为 Box<dyn Error>。

rust
use std::{error::Error, fs};

fn load_port(path: &str) -> Result<u16, Box<dyn Error>> {
    // 读取失败时,立即把 io::Error 转换并返回
    let content = fs::read_to_string(path)?;

    // 解析失败时,立即把 ParseIntError 转换并返回
    let port = content.trim().parse::<u16>()?;
    Ok(port)
}

fn main() -> Result<(), Box<dyn Error>> {
    const PATH: &str = "port.txt";

    fs::write(PATH, "8080\n")?;
    let port = load_port(PATH)?;
    println!("port = {port}");
    fs::remove_file(PATH)?;

    Ok(())
}

预期输出:

text
port = 8080

把文件内容改成 abc 后,parse 会返回错误,load_port 不再执行 Ok(port),而是把转换后的错误直接交给 main。实际错误文本可能随 Rust 版本略有差异,因此业务代码不应依赖标准库错误消息做分支判断。

返回类型与转换规则

? 是否可用,主要取决于当前函数的返回类型,而不是表达式本身。

  • 返回 Result<T, E2> 的函数,可以传播错误类型为 E1 的结果,前提是 E2: From<E1>。
  • 返回 Option<T> 的函数,可以对 Option 使用 ?;遇到 None 时会提前返回 None。
  • Result 与 Option 不能直接互相传播,需要先使用 ok()、ok_or() 或 ok_or_else() 显式转换。
  • main 也可以返回 Result,这样初始化阶段的错误能够直接交给运行时报告。

? 只负责传播,不能替代恢复逻辑。需要补充上下文、重试或改用默认值时,应先使用 map_err、or_else、unwrap_or_else 等方法处理,再决定是否继续传播。

常见边界

在闭包中使用 ? 时,闭包自身也必须返回兼容的 Result 或 Option。如果闭包预期返回普通值,编译器不会把外层函数的返回类型自动套用到闭包上。

异步函数中的规则相同:async fn 声明为 Result<T, E> 后,可以在函数体内传播兼容错误;await 只负责等待异步结果,真正触发传播的是随后使用的 ?。

本课总结

  • ? 在成功时解包值,在失败时提前返回
  • 错误类型不一致时,编译器通过 From 尝试转换
  • 需要恢复、补充上下文或分类处理时,应先处理再传播

下一课预告

下一课将使用枚举、Display、Error 和 From 定义业务可识别的错误类型,让调用方能够按错误类别采取不同处理策略。

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

目录与阅读设置

阅读设置

17

记录一个想法

传播错误

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

登录哪都通