Rust / 系统课时

保留 source 错误链而非字符串

保留 source 错误链而非字符串

错误跨越模块边界时,最容易出现的损失不是消息变短,而是原始错误被提前格式化成普通字符串。这样虽然还能看到文字,却失去了类型和 Error::source 关系。正确做法是让包装错误持有原错误,使调用方能够沿错误链一直追到根因。

学习目标

  • 理解把错误转成字符串为什么会切断 Error::source 链
  • 使用自定义错误类型保存底层错误对象而不是只保存其文本
  • 通过 source() 逐层验证包装错误与根因之间的关系

字符串为什么不是错误链

类似 format!("端口解析失败: {err}") 的代码只保留了 Display 产生的文本。格式化完成后,调用方无法再判断原错误是不是 ParseIntError,也不能调用 source() 继续遍历,更无法基于类型执行针对性的诊断。

错误边界真正需要保存的是“包装错误对象指向底层错误对象”的关系,而不是把两条消息拼成一条字符串。这样展示层仍然可以格式化文本,诊断层则保留结构化信息。

Rust source 错误链结构

用 Error::source 保存根因

下面使用标准库实现一个包装错误。PortConfigError 保存 ParseIntError 本身,并在 Error::source 中返回它的引用,因此外部代码既能看到应用层语义,也能访问真正的解析错误。

rust
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,预期输出:

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

把字符串化推迟到真正的输出边界,可以同时获得清晰的人类可读消息和完整的机器可追踪错误链。

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

目录与阅读设置

阅读设置

17

记录一个想法

保留 source 错误链而非字符串

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

登录哪都通