Golang包内错误如何正确传递

Go中错误通过返回值传递，调用方判断并决定处理或传播；推荐用%w包装错误保留上下文，结合errors.Is和errors.As分析错误类型，根据函数职责决定错误处理或传递，保持错误链完整。

在Go语言中，包内函数的错误传递是一个常见且关键的问题。处理得当能让程序更健壮、逻辑更清晰。核心做法是：函数将错误作为返回值显式传递，调用方根据需要判断并决定是否继续传播或处理。

错误的基本传递方式

Go习惯将错误作为最后一个返回值返回。被调用函数执行失败时，返回一个非nil的error，调用方接收后判断处理。

例如：

func calculate(x, y float64) (float64, error) {
  result, err := divide(x, y)
  if err != nil {
    return 0, err // 直接传递错误
  }
  return result * 2, nil
}

这里calculate调用了divide，发现出错后直接将错误返回，这是最直接的错误传递方式。

包装错误以保留上下文

直接返回原始错误有时会丢失调用链信息。从Go 1.13开始，推荐使用%w格式化动词包装错误，这样可以保留原始错误并附加上下文。

比如：

这样上层调用者可以通过errors.Unwrap或errors.Is/errors.As分析原始错误类型，同时知道是在读取哪个文件时出的问题。

何时该处理 vs 何时该传递

不是所有错误都要往外传。基本原则是：当前函数有能力解决的错误就本地处理；否则应传递给上层。

例如：

• 文件不存在，但可创建默认配置 —— 可在当前函数处理
• 数据库连接失败，无法继续 —— 应传递错误让上层决策
• 参数校验失败 —— 立即返回错误，避免后续执行

如果只是记录日志而不做其他处理，通常不应吞掉错误，仍需传递出去。

使用errors.As和errors.Is进行错误判断

当需要对特定类型的错误做出反应时（如重试网络请求），可用errors.As提取具体错误类型，或用errors.Is判断是否为某个预定义错误。

示例：

var pathError *os.PathError
if errors.As(err, &pathError) {
  log.Printf("Path error: %v", pathError.Path)
}

即使错误被多次包装，这些方法也能正确识别原始错误。

基本上就这些。关键是保持错误链完整，合理添加上下文，并在合适层级做决策。不复杂但容易忽略细节。