Golang错误处理与堆栈打印实例

Golang小白一枚，正在不断学习积累知识，现将学习到的知识记录一下，也是将我的所得分享给大家！而今天这篇文章《Golang错误处理与堆栈打印示例》带大家来了解一下##content_title##，希望对大家的知识积累有所帮助，从而弥补自己的不足，助力实战开发！

Go 1.13+通过fmt.Errorf("%w")支持错误包装，errors.Is和errors.As用于判断和解包；结合pkg/errors的Wrap、WithStack可记录堆栈，推荐底层返回具体错误，中间层用Wrap加上下文与堆栈，顶层用%+v输出完整信息。

在Go语言中，错误处理是程序健壮性的重要组成部分。从Go 1.13开始，标准库引入了错误包装（error wrapping）机制，允许你将一个错误“包装”进另一个错误中，同时保留原始错误信息。结合第三方库如 pkg/errors，还能方便地记录堆栈信息，帮助定位问题。

标准库中的错误包装（Go 1.13+）

Go 1.13 在 fmt 和 errors 包中加入了对错误包装的支持：

• 使用 fmt.Errorf("%w", err) 可以包装错误
• 使用 errors.Is 判断错误是否匹配某个目标
• 使用 errors.As 将错误链解包为特定类型

示例代码：

package main

import (
  "errors"
  "fmt"
)

func readFile() error {
  return fmt.Errorf("read file failed: %w", errors.New("file not found"))
}

func processFile() error {
  return fmt.Errorf("process file error: %w", readFile())
}

func main() {
  err := processFile()
  if err != nil {
    fmt.Printf("Error: %v\n", err)
    if errors.Is(err, errors.New("file not found")) {
      fmt.Println("Caught specific error: file not found")
    }
  }
}

输出：

Error: process file error: read file failed: file not found
Caught specific error: file not found

使用 pkg/errors 记录堆栈信息

标准库不自动记录调用堆栈。github.com/pkg/errors 提供了 errors.WithStack() 和 errors.Wrap() 来附加堆栈信息。

安装：

go get github.com/pkg/errors

示例代码：

package main

import (
  "fmt"
  "github.com/pkg/errors"
)

func readConfig() error {
  return errors.New("config not found")
}

func loadConfig() error {
  return errors.WithStack(readConfig())
}

func runApp() error {
  return errors.Wrap(loadConfig(), "failed to load config")
}

func main() {
  err := runApp()
  if err != nil {
    fmt.Printf("Error: %+v\n", err)
  }
}

输出（包含堆栈）：

Error: failed to load config: config not found
github.com/pkg/errors.(*withStack).Wrapf
  .../pkg/errors/errors.go:279
main.loadConfig
  .../main.go:14
main.runApp
  .../main.go:18
main.main
  .../main.go:23

%+v 会打印完整的堆栈跟踪，而 %v 只显示错误消息链。

结合使用标准库与 pkg/errors 的建议

如果你希望兼容标准库的 errors.Is 和 errors.As，同时保留堆栈，pkg/errors 也提供了兼容方式：

• 使用 errors.Wrap(err, msg) 包装错误并加堆栈
• 使用 errors.WithMessage(err, msg) 添加上下文但不加堆栈
• %+v 输出完整堆栈，%v 输出简洁信息

实际项目中推荐：

• 底层返回具体错误（如 errors.New 或自定义类型）
• 中间层使用 errors.Wrap 添加上下文和堆栈
• 顶层统一打印或日志输出使用 fmt.Printf("%+v")

基本上就这些。错误包装加堆栈能显著提升排查效率，尤其在多层调用场景下。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。