Go 1.13引入错误链机制,通过%w包装错误并保留上下文,使用errors.Is判断是否包含特定错误(如ErrPermission),errors.As提取具体类型错误,自定义错误可实现Unwrap方法构成错误链,便于逐层排查问题。
在Go语言中,错误处理是程序健壮性的重要组成部分。从Go 1.13开始,标准库引入了错误链(Error Wrapping)和Unwrap
机制,使得我们不仅能捕获底层错误,还能保留调用链中的上下文信息。这为排查问题提供了极大便利。
错误包装(Wrapping Errors)
当你在一个函数中处理来自底层的错误,并希望添加额外上下文时,可以使用%w
动词进行包装。
示例:
package main import ( "errors" "fmt" ) func readFile() error { return fmt.Errorf("读取文件失败: %w", errors.New("权限不足")) } func processFile() error { return fmt.Errorf("处理文件时出错: %w", readFile()) }
这里,processFile
包装了 readFile
的错误,而后者又包装了原始错误“权限不足”。整个错误形成一条链。
立即学习“go语言免费学习笔记(深入)”;
使用Is和As判断特定错误
标准库提供 errors.Is
和 errors.As
函数来遍历错误链,判断是否包含某个目标错误。
errors.Is 用于比较两个错误是否相等(或被包装):
err := processFile() if errors.Is(err, errors.New("权限不足")) { fmt.Println("发生了权限不足错误") }
注意: 上面直接使用 errors.New("权限不足")
在实际中不推荐,因为每次调用都会创建新值。应定义变量:
var ErrPermission = errors.New("权限不足") // 使用 return fmt.Errorf("读取文件失败: %w", ErrPermission) // 判断 if errors.Is(err, ErrPermission) { fmt.Println("权限问题") }
errors.As 用于将错误链中的某个错误提取到指定类型的变量中:
if e, ok := err.(*MyCustomError); ok { // 传统方式,无法穿透包装 } // 正确方式 var target *MyCustomError if errors.As(err, &target) { fmt.Printf("自定义错误: %vn", target.Code) }
手动实现Unwrap方法
你也可以在自定义错误类型中实现 Unwrap() error
方法,构建自己的错误链。
type MyError struct { Msg string Code int Err error // 被包装的错误 } func (e *MyError) Error() string { return fmt.Sprintf("[%d] %s: %v", e.Code, e.Msg, e.Err) } func (e *MyError) Unwrap() error { return e.Err }
使用示例:
err := &MyError{ Msg: "业务逻辑出错", Code: 500, Err: fmt.Errorf("数据库连接失败: %w", errors.New("网络超时")), } // 遍历错误链 for e := err; e != nil; e = errors.Unwrap(e) { fmt.Println(e) }
输出会逐层显示包装的错误,直到最底层。
基本上就这些。通过合理使用%w
、Is
、%w
0和Unwrap
,可以让Go程序的错误处理更清晰、可追溯。关键是不要丢失原始错误,同时提供足够的上下文。不复杂但容易忽略。