Rust / 系统课时
按调用者动作划分错误变体
按调用者动作划分错误变体
设计领域错误时,最容易犯的错是把数据库、HTTP、解析器的每一种底层失败原样搬到上层。这样虽然“信息很全”,调用者却必须理解实现细节。本节用 Rust 枚举演示一种更稳定的做法:先看调用者遇到错误后要做什么,再决定哪些失败值得成为独立变体。
学习目标
- 能从调用者的恢复动作反推错误枚举的边界
- 能把多个底层错误收敛为少量稳定的领域错误
- 能判断何时应该保留独立变体,何时应该合并
先从调用者要做什么开始
错误类型不是底层异常目录,而是调用者可观察到的失败协议。设计变体前,可以先问三个问题:调用者能否修改输入后重试、能否稍后自动重试,还是只能记录并终止当前流程。
例如“用户名已存在”需要提示用户换一个名称;数据库超时和连接短暂断开都可能是“稍后重试”;底层解码异常则通常属于内部故障。虽然底层原因不同,但如果调用者的处理动作相同,就没有必要让上层分别匹配。
把底层错误映射到稳定变体
下面的完整示例故意定义了四种底层数据库错误,但对外只暴露三种注册错误。Timeout 与 ConnectionClosed 被合并,因为调用者对它们采取相同动作。
#[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));
}
}预期输出:
UsernameTaken -> prompt user to change username
TemporarilyUnavailable -> retry later
TemporarilyUnavailable -> retry later
Internal -> record and abort这里真正稳定的是“调用者动作”,不是数据库驱动的错误码。如果未来更换数据库,只要新的底层错误仍能映射到这三类动作,上层接口就不必跟着变化。
什么时候应该拆成独立变体
只有当上层确实需要不同处理时,拆分才有价值。比如“用户名已占用”和“邮箱已占用”如果界面要定位到不同输入框,就应该是两个可区分的变体;如果两者最终都只显示同一条“注册信息冲突”,合并反而更简单。
反过来,也不要为了追求枚举短小而把所有失败都压成 Internal。一旦调用者能够安全地修正输入、重试或选择其他资源,就应该保留足够的信息让这种动作可实现。
避免把实现细节变成公共契约
底层库的错误类型可以保留在模块内部,用于日志、错误链或诊断;对外暴露的领域错误则应表达业务含义和恢复策略。这样既不会丢失调试能力,也能避免上层代码依赖某个数据库、HTTP 客户端或解析库的具体错误枚举。
一个可演进的错误类型,本质上是在回答“调用者接下来能做什么”。先稳定这个协议,再决定需要暴露多少底层原因,错误模型会比逐个复制异常更耐改。