Rust / 系统课时

按调用者动作划分错误变体

按调用者动作划分错误变体

设计领域错误时,最容易犯的错是把数据库、HTTP、解析器的每一种底层失败原样搬到上层。这样虽然“信息很全”,调用者却必须理解实现细节。本节用 Rust 枚举演示一种更稳定的做法:先看调用者遇到错误后要做什么,再决定哪些失败值得成为独立变体。

学习目标

  • 能从调用者的恢复动作反推错误枚举的边界
  • 能把多个底层错误收敛为少量稳定的领域错误
  • 能判断何时应该保留独立变体,何时应该合并

先从调用者要做什么开始

错误类型不是底层异常目录,而是调用者可观察到的失败协议。设计变体前,可以先问三个问题:调用者能否修改输入后重试、能否稍后自动重试,还是只能记录并终止当前流程。

例如“用户名已存在”需要提示用户换一个名称;数据库超时和连接短暂断开都可能是“稍后重试”;底层解码异常则通常属于内部故障。虽然底层原因不同,但如果调用者的处理动作相同,就没有必要让上层分别匹配。

把底层错误映射到稳定变体

下面的完整示例故意定义了四种底层数据库错误,但对外只暴露三种注册错误。Timeout 与 ConnectionClosed 被合并,因为调用者对它们采取相同动作。

rust
#[derive(Debug)]
enum DbError {
    UniqueViolation,
    Timeout,
    ConnectionClosed,
    Decode,
}

#[derive(Debug)]
enum RegisterError {
    UsernameTaken,
    TemporarilyUnavailable,
    Internal,
}

fn map_db_error(error: DbError) -> RegisterError {
    match error {
        DbError::UniqueViolation => RegisterError::UsernameTaken,
        DbError::Timeout | DbError::ConnectionClosed => {
            RegisterError::TemporarilyUnavailable
        }
        DbError::Decode => RegisterError::Internal,
    }
}

fn caller_action(error: &RegisterError) -> &'static str {
    match error {
        RegisterError::UsernameTaken => "prompt user to change username",
        RegisterError::TemporarilyUnavailable => "retry later",
        RegisterError::Internal => "record and abort",
    }
}

fn main() {
    let errors = [
        DbError::UniqueViolation,
        DbError::Timeout,
        DbError::ConnectionClosed,
        DbError::Decode,
    ];

    for error in errors {
        let public_error = map_db_error(error);
        println!("{public_error:?} -> {}", caller_action(&public_error));
    }
}

预期输出:

text
UsernameTaken -> prompt user to change username
TemporarilyUnavailable -> retry later
TemporarilyUnavailable -> retry later
Internal -> record and abort

这里真正稳定的是“调用者动作”,不是数据库驱动的错误码。如果未来更换数据库,只要新的底层错误仍能映射到这三类动作,上层接口就不必跟着变化。

什么时候应该拆成独立变体

只有当上层确实需要不同处理时,拆分才有价值。比如“用户名已占用”和“邮箱已占用”如果界面要定位到不同输入框,就应该是两个可区分的变体;如果两者最终都只显示同一条“注册信息冲突”,合并反而更简单。

反过来,也不要为了追求枚举短小而把所有失败都压成 Internal。一旦调用者能够安全地修正输入、重试或选择其他资源,就应该保留足够的信息让这种动作可实现。

避免把实现细节变成公共契约

底层库的错误类型可以保留在模块内部,用于日志、错误链或诊断;对外暴露的领域错误则应表达业务含义和恢复策略。这样既不会丢失调试能力,也能避免上层代码依赖某个数据库、HTTP 客户端或解析库的具体错误枚举。

一个可演进的错误类型,本质上是在回答“调用者接下来能做什么”。先稳定这个协议,再决定需要暴露多少底层原因,错误模型会比逐个复制异常更耐改。

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

目录与阅读设置

阅读设置

17

记录一个想法

按调用者动作划分错误变体

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

登录哪都通