Go项目使用Zerolog时，如何优化错误日志与传递的重复操作？

我在Go应用中使用zerolog进行日志记录，想遵循仅在调用栈顶层抛出错误的最佳实践，但不确定怎么同时写错误日志并向上传递错误。当前的实现代码如下：

func VeryDeepFunction() (int, error) {
   err := doSomethingThatCouldCauseError()
   if err != nil {
      errMsg := fmt.Sprintf("something bad happened: %+v", err)
      log.Error().Msgf(errMsg)
      return 0, fmt.Errorf(errMsg)
   }
   return 1, nil
}

我认为这种格式化字符串、记录日志再包装错误的方式存在冗余，想询问是否有更规范的实现方式？

优化方案 #

核心思路是拆分错误包装与日志记录的职责，底层函数仅负责给错误添加上下文，统一由顶层函数处理日志输出，既符合顶层抛错的最佳实践，又避免冗余操作。

1. 底层函数仅包装错误

底层函数专注业务逻辑，只给原始错误添加上下文信息，不做日志记录：

func VeryDeepFunction() (int, error) {
    err := doSomethingThatCouldCauseError()
    if err != nil {
        // 使用%w包装错误，保留原始错误链，方便后续错误判断
        return 0, fmt.Errorf("something bad happened: %w", err)
    }
    return 1, nil
}

2. 顶层函数统一处理日志与返回

在调用栈的顶层（如HTTP Handler、main函数、业务入口函数）捕获错误，统一完成日志记录和结果返回：

func TopLevelFunction() {
    result, err := VeryDeepFunction()
    if err != nil {
        // 用zerolog的Err()方法直接传入错误，自动处理格式化
        log.Error().Err(err).Msg("failed to execute very deep function")
        // 根据业务场景决定后续处理（如返回HTTP错误码、终止流程等）
        return
    }
    // 处理正常业务结果
    fmt.Println("Result:", result)
}

3. 中间层函数的处理（可选）

如果调用栈存在多层中间函数，中间层只需继续向上传递错误，无需额外日志或重复包装：

func MiddleFunction() (int, error) {
    result, err := VeryDeepFunction()
    if err != nil {
        return 0, fmt.Errorf("middle function failed: %w", err)
    }
    return result, nil
}

这种方式会保留完整的错误上下文链，顶层日志时能清晰看到错误的传播路径（若使用github.com/pkg/errors等支持栈追踪的库，还能打印调用栈信息）。

特殊场景：底层需即时日志

如果某些关键操作必须在底层记录日志，可借助zerolog的Err()方法简化代码，避免重复格式化：

func VeryDeepFunction() (int, error) {
    err := doSomethingThatCouldCauseError()
    if err != nil {
        wrappedErr := fmt.Errorf("something bad happened: %w", err)
        log.Error().Err(wrappedErr).Msg("")
        return 0, wrappedErr
    }
    return 1, nil
}

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