Golang 中的 error 是一个内置的特殊的接口类型:
type error interface { Error() string}
在 Go 1.13 版本之前,有关 error 的方法只有两个:
func New(text string) error
func Errorf(format string, a ...interface{}) error
这两个方法都是用来生成一个新的 error 类型的数据。
01
—
1.13 版本之前的错误处理
最常见的,判断是否为 nil :
if err != nil {
// something went wrong
}
判断是否为某个特定的错误:
var ErrNotFound = errors.New("not found")
if err == ErrNotFound {
// something wasn't found
}
error 是一个带有 Error 方法的接口类型,这意味着你可以自己去实现这个接口:
type NotFoundError struct {
Name string
}
func (e *NotFoundError) Error() string {
return e.Name + ": not found"
}
if e, ok := err.(*NotFoundError); ok {
// e.Name wasn't found
}
处理错误的时候我们通常会添加一些额外的信息,记录错误的上下文以便于后续排查:
if err != nil {
return fmt.Errorf("错误上下文 %v: %v", name, err)
}
fmt.Errorf 方法会创建一个包含有原始错误文本信息的新的 error ,但是与原始错误之间是没有任何关联的。
然而我们有时候是需要保留这种关联性的,这时候就需要我们自己去定义一个包含有原始错误的新的错误类型,比如自定义一个 QueryError :
type QueryError struct {
Query string Err error // 与原始错误关联
}
然后可以判断这个原始错误是否为某个特定的错误,比如 ErrPermission :
if e, ok := err.(*QueryError); ok && e.Err == ErrPermission {
// query failed because of a permission problem
}
写到这里,你可以发现对于错误的关联嵌套情况处理起来是比较麻烦的,而 Go 1.13 版本对此做了改进。
02
—
1.13 版本之后的错误处理
首先需要说明的是,Go 是向后兼容的,上文中的 1.13 版本之前的用法完全可以继续使用。
1.13 版本的改进是:
func Unwrap(err error) error
func Is(err, target error) bool
func As(err error, target interface{}) bool
下面进行详细说明。
对于错误嵌套的情况,Unwrap 方法可以用来返回某个错误所包含的底层错误,例如 e1 包含了 e2 ,这里 Unwrap e1 就可以得到 e2 。Unwrap 支持链式调用(处理错误的多层嵌套)。
使用 errors.Is 和 errors.As 方法检查错误:
if errors.Is(err, ErrNotFound) {
// something wasn't found
}
var e *QueryError
if errors.As(err, &e) {
// err is a *QueryError, and e is set to the error's value
}
errors.Is 方法会对嵌套的情况展开判断,这意味着:
if e, ok := err.(*QueryError); ok && e.Err == ErrPermission {
// query failed because of a permission problem
}
可以直接简写为:
if errors.Is(err, ErrPermission) {
// err, or some error that it wraps, is a permission problem
}
fmt.Errorf 方法通过 %w 包装错误:
if err != nil {
return fmt.Errorf("错误上下文 %v: %v", name, err)
}
上面通过 %v 是直接返回一个与原始错误无法关联的新的错误。
我们使用 %w 就可以进行关联了:
if err != nil {
// Return an error which unwraps to err.
return fmt.Errorf("错误上下文 %v: %w", name, err)
}
一旦使用 %w 进行了关联,就可以使用 errors.Is 和 errors.As 方法了:
err := fmt.Errorf("access denied: %w”, ErrPermission)
...
if errors.Is(err, ErrPermission) ...
对于是否包装错误以及如何包装错误并没有统一的答案。
本文分享自 Node Python Go全栈开发 微信公众号,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。
本文参与 腾讯云自媒体同步曝光计划 ,欢迎热爱写作的你一起参与!
扫码关注腾讯云开发者
领取腾讯云代金券
Copyright © 2013 - 2025 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号:粤B2-20090059 深公网安备号 44030502008569
腾讯云计算(北京)有限责任公司 京ICP证150476号 | 京ICP备11018762号 | 京公网安备号11010802020287
Copyright © 2013 - 2025 Tencent Cloud.
All Rights Reserved. 腾讯云 版权所有