go 1.13 引入错误包装与解包机制,通过 fmt.Errorf 配合 %w 动词添加上下文并保留原始错误,便于多层调用中追踪错误源头;使用 errors.Unwrap 可提取被包装的原始错误,但仅限 %w 包装的错误有效;为判断包装后的错误类型或值,推荐使用 errors.Is 检查错误链中是否包含目标错误,errors.As 判断是否为特定类型并赋值,二者均递归遍历错误链,提升错误处理的准确性和调试效率。
在 Go 语言中,错误处理是程序健壮性的关键部分。从 Go 1.13 开始,标准库引入了对错误包装(wrapping)和解包(unwrapping)的支持,使得我们可以在保留原始错误信息的同时添加上下文,便于调试和日志追踪。
错误包装:添加上下文信息
错误包装是指在一个错误的基础上,附加更丰富的上下文信息,同时保留原始错误。这在多层调用中非常有用,比如从数据库层到业务逻辑层再到 API 层。
使用 fmt.Errorf 配合 %w 动词可以实现错误包装:
立即学习“go语言免费学习笔记(深入)”;
return fmt.Errorf(“failed to read config: %w”, err)
}
这样,返回的错误就包含了“failed to read config”这一层上下文,同时内部保存了原始错误,可用于后续分析。
错误解包:获取原始错误
当一个错误被多层包装后,我们可能需要检查最底层的原始错误类型或值,例如判断是否是超时错误或网络连接错误。
Go 提供了 errors.Unwrap 函数来获取被包装的错误:
if err := doSomething(); err != nil {
unwrapped := errors.Unwrap(err)
if unwrapped != nil {
fmt.Println(“unwrapped error:”, unwrapped)
}
}
注意:只有通过 %w 包装的错误才能被 Unwrap 正确提取。
使用 Is 和 As 判断包装后的错误
直接比较错误值(如 err == ErrNotFound)在包装后会失效。为此,Go 提供了 errors.Is 和 errors.As 来安全地判断包装错误。
- errors.Is(err, target):判断 err 或其任意包装层是否等于目标错误
- errors.As(err, &target):判断 err 或其任意包装层是否为指定类型的错误,并赋值
示例:
if errors.Is(err, sql.ErrNoRows) {
log.Println(“no user found”)
}
var pathErr *os.PathError
if errors.As(err, &pathErr) {
fmt.Println(“file error:”, pathErr.Path)
}
这两个函数会递归检查错误链,直到找到匹配项或到底为止。
基本上就这些。合理使用错误包装和解包,能让错误信息更清晰,调试更高效,同时保持代码的可维护性。关键是用好 %w、Is 和 As。不复杂但容易忽略。
评论(已关闭)
评论已关闭