Golang错误包装与堆栈信息打印示例-Golang-PHP中文网

Golang错误包装与堆栈信息打印示例

P粉602998670

发布： 2025-10-03 09:01:02

原创

806人浏览过

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

golang错误包装与堆栈信息打印示例

在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")
    }
  }
}

输出：

立即学习“go语言免费学习笔记（深入）”；

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() 来附加堆栈信息。

安装：

微信 WeLM

WeLM不是一个直接的对话机器人，而是一个补全用户输入信息的生成模型。

查看详情

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 只显示错误消息链。