Rust中处理Result错误时执行副作用的惯用方式

针对你提出的需求——在Result为Err时执行副作用（如日志）并返回原错误，目前有几种惯用且语义清晰的实现方式：

1. 标准库inspect_err方法（推荐，Rust 1.70+稳定） #

Rust 1.70版本之后，标准库为Result添加了inspect_err方法，它的设计初衷就是在不修改错误值的前提下，执行Err分支的副作用，完全匹配你的需求：

fn do_something() -> Result<(), MyError> { /* ... */ }

fn foo() -> Result<(), MyError> {
    do_something()
        .inspect_err(|err| println!("Got error in Foo: {:#?}", err))?;
    
    // 后续业务逻辑
    Ok(())
}

这个方法语义明确，既保持了链式调用的简洁性，又不会像map_err那样有“误用转换方法”的违和感。

2. 自定义Result扩展方法 #

如果你的项目使用的Rust版本低于1.70，或者想要更贴合业务的方法名（比如log_err），可以通过trait扩展实现自己的if_err方法：

// 定义扩展trait
trait ResultSideEffect<T, E> {
    fn if_err(self, action: impl FnOnce(&E)) -> Self;
}

// 为Result实现该trait
impl<T, E> ResultSideEffect<T, E> for Result<T, E> {
    fn if_err(self, action: impl FnOnce(&E)) -> Self {
        // 仅在Err分支执行副作用，不修改原Result
        if let Err(ref err) = self {
            action(err);
        }
        self
    }
}

// 使用方式完全符合你的理想写法
fn foo() -> Result<(), MyError> {
    do_something()
        .if_err(|err| println!("Got error in Foo: {:#?}", err))?;
    
    // ...
    Ok(())
}

这种方式灵活性很高，你可以根据需求扩展出不同的副作用方法（比如统一的错误日志封装）。

关于你提到的两种写法 #

• map_err写法：虽然能实现功能，但确实存在语义偏差——map_err的核心是转换错误类型，而非执行副作用。在inspect_err出现之前，这是常见的替代方案，但现在更推荐用语义匹配的inspect_err。
• if let写法：直观易懂，但链式调用的简洁性不足。如果需要在错误分支执行多个复杂操作（比如同时日志上报+统计），这种写法反而会比链式调用更清晰。

内容的提问来源于stack exchange，提问作者Ricola