Rust / 系统课时
anyhow 适合放在哪一层
anyhow 适合放在哪一层
anyhow 擅长把不同错误统一成一个可传播、可附加上下文的应用错误,但类型擦除也会隐藏可枚举的业务语义。本篇通过领域层与应用边界的分工,说明哪里应该保留强类型错误,哪里适合使用 anyhow::Result。
学习目标
- 理解
anyhow类型擦除带来的便利与代价。 - 把可供业务分支判断的错误保留在领域或库契约中。
- 在 CLI、任务入口和应用服务边界为错误补充上下文并统一上抛。
先区分“契约错误”和“执行失败”
领域层、可复用库或公开接口中的错误,往往需要让调用方做明确分支,例如库存不足时返回业务提示,权限错误时要求重新认证。这类错误应保持具体类型,因为调用方需要稳定地 match 它们。
应用入口关心的通常不同:命令执行失败时,需要知道“哪一步失败、底层原因是什么、如何记录或退出”,却不一定需要把每种错误都变成新的顶层枚举。anyhow::Error 正适合承担这类边界汇总与上下文补充。

在应用边界转换,而不是在领域内部擦除
下面的示例让领域函数返回可匹配的 DomainError,应用函数再用 anyhow::Context 增加“正在执行什么”的信息。这样领域错误仍然可以被单元测试和其他调用方精确判断,而最外层获得完整错误链。
要运行示例,项目依赖中需要 anyhow:
[dependencies]
anyhow = "1"src/main.rs:
use anyhow::{Context, Result};
use std::error::Error;
use std::fmt;
#[derive(Debug, PartialEq, Eq)]
enum DomainError {
InvalidQuantity,
}
impl fmt::Display for DomainError {
fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
match self {
DomainError::InvalidQuantity => write!(f, "quantity must be greater than zero"),
}
}
}
impl Error for DomainError {}
fn reserve_stock(quantity: u32) -> std::result::Result<(), DomainError> {
if quantity == 0 {
return Err(DomainError::InvalidQuantity);
}
Ok(())
}
fn run() -> Result<()> {
reserve_stock(0).context("failed to reserve stock")?;
Ok(())
}
fn main() {
if let Err(err) = run() {
println!("{err:#}");
}
}预期输出:
failed to reserve stock: quantity must be greater than zeroDomainError 没有被 anyhow 替代;它只是在应用边界被包装。若另一个调用方直接调用 reserve_stock,仍然可以针对 DomainError::InvalidQuantity 写稳定分支。
为什么不该让领域函数直接返回 anyhow
如果把领域函数直接改成 anyhow::Result<()>,实现会更短,但调用方只能拿到一个被擦除的错误。虽然 anyhow 支持 downcast_ref,这更适合诊断或局部兼容处理,不适合作为长期业务契约:一旦内部换了具体错误类型,依赖 downcast 的调用代码也会跟着失效。
常见的放置方式是:领域层返回自定义枚举或结构体;基础设施层返回自身的具体错误或转换为领域可理解的错误;应用服务、CLI、批处理任务和程序入口使用 anyhow::Result,并在跨越步骤时调用 context 或 with_context。
让上下文描述“正在做什么”
高质量的 context 应描述失败发生时的操作,而不是重复底层错误。例如底层已经写明“permission denied”,上层更有价值的信息是“读取哪个配置”“处理哪个请求”或“同步哪个订单”。
如果上下文需要动态数据,优先用 with_context,因为闭包只在错误路径上构造字符串。应用层可以逐层补充信息,但不要把敏感令牌、密码或完整用户数据写入错误消息。
最终边界可以很简单:需要被调用方稳定匹配的错误保持强类型,需要跨多层传播并形成诊断链的失败在应用边界转成 anyhow。这样既不会把领域契约擦掉,也避免为每个顶层流程维护庞大的总错误枚举。