Rust / 系统课时
传播错误
传播错误
当函数无法自行恢复时,最合适的做法通常不是立即打印或终止程序,而是把错误交给调用者处理。本课通过一个可运行示例说明 ? 如何提前返回错误、如何保留成功值,以及错误类型为何必须能够转换。
学习目标
- 理解
?对Result的提前返回行为 - 使用
?简化多层调用中的错误传播 - 判断返回类型是否满足错误转换要求
问号运算符做了什么
对 Result<T, E> 使用 ? 时,成功分支会取出其中的 T 并继续执行;失败分支会立即结束当前函数,把错误返回给调用者。因此,? 只能出现在返回类型允许传播该错误的函数或闭包中。
它并不是简单地把原始错误原样返回。当前表达式的错误类型为 E1,函数声明的错误类型为 E2 时,编译器会尝试通过 From<E1> for E2 完成转换。无法转换时,代码会在编译阶段失败。
完整示例:读取并解析端口
下面的程序先写入一个临时配置文件,再读取其中的端口号。文件读取可能产生 std::io::Error,字符串解析可能产生 ParseIntError,二者都通过 ? 传播为 Box<dyn Error>。
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(())
}预期输出:
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 定义业务可识别的错误类型,让调用方能够按错误类别采取不同处理策略。