从go 1.13起,Errors包支持通过%w包装错误,形成可追溯的错误链,使用errors.Unwrap解包,errors.Is和errors.As判断和提取特定错误,提升错误处理与调试能力。

在Go语言中,从1.13版本开始,errors 包引入了对错误包装(error wrapping)的支持,允许你将一个错误“包装”进另一个错误中,同时保留原始错误的信息。这种机制非常适合实现错误的链式包装,便于追踪错误源头并添加上下文信息。
使用 %w 格式动词进行错误包装
在调用 fmt.Errorf 时,使用 %w 动词可以将一个已有错误包装到新错误中:
- 新错误会包含原始错误
- 可通过 errors.Unwrap 提取被包装的错误
- 支持多层包装,形成错误链
示例代码:
package main import ( "errors" "fmt" ) func readFile() error { return fmt.Errorf("读取文件失败: %w", errors.New("文件不存在")) } func processFile() error { return fmt.Errorf("处理文件时出错: %w", readFile()) } func main() { err := processFile() fmt.Println(err) // 输出:处理文件时出错: 读取文件失败: 文件不存在 }
通过 errors.Is 和 errors.As 判断和提取错误
Go 提供了安全的方式来检查错误链中是否包含特定错误:
立即学习“go语言免费学习笔记(深入)”;
- errors.Is(err, target):判断错误链中是否存在目标错误
- errors.As(err, &target):判断错误链中是否有指定类型的错误,并赋值
示例:
if errors.Is(err, os.ErrNotExist) { fmt.Println("文件不存在") } var pathErr *os.PathError if errors.As(err, &pathErr) { fmt.Printf("路径错误: %vn", pathErr.Path) }
手动构建多层错误链
你可以逐层包装错误,形成清晰的调用链:
err := errors.New("数据库连接失败") err = fmt.Errorf("服务启动失败: %w", err) err = fmt.Errorf("系统初始化失败: %w", err) // 使用 errors.Unwrap 可逐层解开 for current := err; current != nil; current = errors.Unwrap(current) { fmt.Println(current) }
基本上就这些。只要使用 %w 包装、配合 Is/As 检查,就能在Go中高效管理错误链,提升调试和日志能力。


