Rust 2026 经验谈 - 错误处理体系 2026

1
use thiserror::Error;
2

3
#[derive(Error, Debug)]
4
pub enum DataStoreError {
5
    #[error("data store disconnected")]
6
    Disconnect(#[from] io::Error),
7

8
    #[error("the data for key `{0}` is not available")]
9
    Redaction(String),
10

11
    #[error("invalid header (expected {expected:?}, found {found:?})")]
12
    InvalidHeader {
13
        expected: String,
14
        found: String,
15
    },
16

17
    #[error("unknown data store error")]
18
    Unknown,
19
}

1
use thiserror::Error;
2

3
#[derive(Error, Debug)]
4
pub enum AppError {
5
    // #[error(transparent)] 透传底层错误（1.0 已支持，2.0 改进与 Provider API 协作）
6
    #[error(transparent)]
7
    Io(#[from] std::io::Error),
8

9
    #[error(transparent)]
10
    Parse(#[from] std::num::ParseIntError),
11

12
    // 2.0 改进的 #[source] 与 Display 格式化协作
13
    #[error("configuration error at {path}:{line}")]
14
    Config {
15
        path: String,
16
        line: usize,
17
        #[source]
18
        source: ConfigParseError,
19
    },
20
}
21

22
#[derive(Error, Debug)]
23
#[error("invalid config value: {msg}")]
24
struct ConfigParseError {
25
    msg: String,
26
}

1
// ❌ 库返回 anyhow::Error
2
pub fn parse(data: &[u8]) -> anyhow::Result<Parsed> {
3
    // ...
4
}
5

6
// 问题：调用者无法匹配具体错误
7
fn caller() {
8
    match parse(&data) {
9
        Ok(parsed) => { /* ... */ },
10
        Err(e) => {
11
            // e 是 anyhow::Error，只能 downcast
12
            if e.is::<std::io::Error>() {
13
                // 但这很脆弱，且丧失了穷尽性检查
14
            }
15
        },
16
    }
17
}
18

19
// ✅ 库返回具体错误类型
20
pub fn parse(data: &[u8]) -> Result<Parsed, ParseError> {
21
    // ...
22
}
23

24
fn caller() {
25
    match parse(&data) {
26
        Ok(parsed) => { /* ... */ },
27
        Err(ParseError::InvalidFormat(line)) => { /* 处理格式错误 */ },
28
        Err(ParseError::Overflow) => { /* 处理溢出 */ },
29
    }
30
}

1
use std::error::Error;
2

3
fn print_error_chain(err: &dyn Error) {
4
    let mut level = 0;
5
    let mut source = Some(err);
6
    while let Some(e) = source {
7
        println!("{:width$}→ {}", level, e, width = level * 2);
8
        source = e.source();
9
        level += 1;
10
    }
11
}
12

13
// 输出示例：
14
// → failed to read config from /etc/app.toml
15
//   → No such file or directory (os error 2)

1
#[derive(Error, Debug)]
2
pub enum StoreError {
3
    #[error("database query failed")]
4
    Query(#[from] sql::Error),  // #[from] 自动实现 From<sql::Error> 和 source()
5

6
    #[error("connection pool exhausted")]
7
    PoolExhausted,
8
}
9

10
// sql::Error 作为 StoreError::Query 的 source
11
fn demo(err: StoreError) {
12
    if let Some(source) = err.source() {
13
        println!("caused by: {}", source);  // 打印 sql::Error
14
    }
15
}

1
fn process(items: &[&str]) -> Result<Vec<i32>, AppError> {
2
    // ❌ 常见错误：试图对 Iterator<Item=Result<_, _>> 使用 ?
3
    // items.iter().map(|s| s.parse::<i32>()).collect()?
4
    //                             ^^^^^^^^ 返回 Result<i32, ParseIntError>
5
    // collect() 对 Iterator<Item=Result<i32, ParseIntError>> 的行为是：
6
    //   如果任何元素是 Err，返回 Err(第一个错误)
7
    //   否则返回 Ok(Vec<i32>)
8
    // 但 ? 作用于 collect 的结果，类型是 Result<Vec<i32>, ParseIntError>
9
    // 需要 From<ParseIntError> for AppError
10

11
    // ✅ 正确写法
12
    items.iter()
13
        .map(|s| s.parse::<i32>().map_err(AppError::from))
14
        .collect::<Result<Vec<_>, _>>()
15
}

1
use std::any::{Demand, Provider};
2

3
impl Provider for RequestError {
4
    fn provide<'a>(&'a self, demand: &mut Demand<'a>) {
5
        demand.provide_ref::<String>(&self.url);
6
        demand.provide_ref::<u16>(&self.status);
7
        demand.provide_ref::<std::io::Error>(&self.source);
8
    }
9
}
10

11
// 消费者按类型提取上下文
12
fn inspect(err: &dyn Provider) {
13
    if let Some(url) = demand.provide_ref::<String>() {
14
        println!("failed URL: {}", url);
15
    }
16
    // 注意：此处展示的是 Provider API 的核心思路
17
    // 完整的 demand 提取 API 在稳定化过程中可能有所调整
18
}

1
use color_eyre::{eyre::eyre, Help, Result};
2

3
fn read_config() -> Result<Config> {
4
    let content = std::fs::read_to_string("config.toml")
5
        .with_suggestion(|| "try creating config.toml with default settings")?;  // 帮助建议
6

7
    Ok(toml::from_str(&content)?)
8
}
9

10
fn main() -> Result<()> {
11
    color_eyre::install()?;  // 初始化 color-eyre 的错误处理器
12

13
    let config = read_config()?;
14
    Ok(())
15
}