Rust / 系统课时
保留 source 错误链而非字符串
保留 source 错误链而非字符串
错误跨越模块边界时,最容易出现的损失不是消息变短,而是原始错误被提前格式化成普通字符串。这样虽然还能看到文字,却失去了类型和 Error::source 关系。正确做法是让包装错误持有原错误,使调用方能够沿错误链一直追到根因。
学习目标
- 理解把错误转成字符串为什么会切断
Error::source链 - 使用自定义错误类型保存底层错误对象而不是只保存其文本
- 通过
source()逐层验证包装错误与根因之间的关系
字符串为什么不是错误链
类似 format!("端口解析失败: {err}") 的代码只保留了 Display 产生的文本。格式化完成后,调用方无法再判断原错误是不是 ParseIntError,也不能调用 source() 继续遍历,更无法基于类型执行针对性的诊断。
错误边界真正需要保存的是“包装错误对象指向底层错误对象”的关系,而不是把两条消息拼成一条字符串。这样展示层仍然可以格式化文本,诊断层则保留结构化信息。

用 Error::source 保存根因
下面使用标准库实现一个包装错误。PortConfigError 保存 ParseIntError 本身,并在 Error::source 中返回它的引用,因此外部代码既能看到应用层语义,也能访问真正的解析错误。
use std::error::Error;
use std::fmt;
use std::num::ParseIntError;
#[derive(Debug)]
struct PortConfigError {
service: String,
source: ParseIntError,
}
impl fmt::Display for PortConfigError {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
write!(f, "无法解析服务 {} 的监听端口", self.service)
}
}
impl Error for PortConfigError {
fn source(&self) -> Option<&(dyn Error + 'static)> {
// 返回原始错误对象,而不是重新构造一段错误文本。
Some(&self.source)
}
}
fn parse_port(service: &str, raw: &str) -> Result<u16, PortConfigError> {
raw.parse::<u16>().map_err(|source| PortConfigError {
service: service.to_owned(),
source,
})
}
fn main() {
if let Err(err) = parse_port("api", "eighty") {
eprintln!("error: {err}");
// 调用方可以沿标准 Error 链继续查看真正的根因。
if let Some(source) = err.source() {
eprintln!("caused by: {source}");
}
}
}执行 cargo run --quiet,预期输出:
error: 无法解析服务 api 的监听端口
caused by: invalid digit found in string如果 PortConfigError 只保存一个 String,第二行对应的结构化来源就不存在了。即使字符串里手工拼接了相同文字,也只是看起来相似,错误系统已经无法知道那段文本来自哪个错误对象。
Display、Debug 和 source 各自负责什么
Display 负责给人看的当前层描述,例如“无法解析服务 api 的监听端口”;Debug 通常用于开发诊断,可以包含类型和字段信息;source() 则明确表达“这一层错误由哪个更底层错误导致”。三者解决的是不同问题,不应通过把 Debug 或 Display 提前格式化来替代错误链。
当错误库提供 #[source]、透明包装或自动派生功能时,本质上仍是在维护这条对象关系。无论使用标准库、thiserror 还是 anyhow,判断实现是否正确的关键都是:底层错误对象是否还在,而不是它的文字是否被复制到了新字符串中。
什么时候可以只保留字符串
字符串适合已经到达最终展示边界的场景,例如把错误渲染成 CLI 文本或 HTTP 响应消息;此时后续逻辑不再需要继续诊断该错误。只要错误还会在应用内部传播、记录、分类或上报,就应尽量保留实现 Error 的原始对象和 source 链。
把字符串化推迟到真正的输出边界,可以同时获得清晰的人类可读消息和完整的机器可追踪错误链。