今天早些时候,golang/x/exp
中默默的更新了一个名曰xerrors
的包,这个包和同样处于golang/x/exp
下的另一个名叫errors
的包名字十分相似,就连介绍也都一致:
Package errors implements functions to manipulate errors.
This package implements the Go 2 draft designs for error inspection and printing
从目前的情况来看,基本上错误的处理形式基本已经定型,处理方式则是类似于之前的另一个github.com/pkg/errors
包,但是具体细节不尽相同。
如何处理error?
在之前介绍文章中提到过github.com/pkg/errors
包的设计思路,那么在Go团队的实现中,这种思路也得到了继承。先从一个小例子开始:
package main
import (
"fmt"
"golang.org/x/exp/xerrors"
)
func raiseError() error {
return xerrors.New("a new error")
}
func main() {
err := xerrors.Errorf("raiseError: %w", raiseError())
fmt.Println(err)
}
输出结果:
raiseError: a new error
看起来非常类似于之前github.com/pkg/errors
的显示内容。而其中xerrors.Errorf
则充当了之前errors.Wrap
的功能。 其中值得一提的是%w
,这个用于包装错误,后续验证错误中也会用到其中的值。
同时,这个包中也包含了几个非常有用的辅助函数,分别是:验证错误类型方法Is
、错误类型转换方法As
、错误关系链解除方法Opaque
和提取内层错误方法Unwrap
。我们可以用一个简单的演示来说明这种关系:
var (
ErrBase = xerrors.New("a new error")
)
func main() {
err := xerrors.Errorf("raiseError: %w", ErrBase)
fmt.Println(ErrBase == ErrBase) // 地址相同
fmt.Println(err == ErrBase) // 基于ErrBase包装之后不同
fmt.Println(xerrors.Is(err, ErrBase)) // 验证是否为基于ErrBase
fmt.Println(xerrors.Opaque(err) == err) // 解除关系链之后不为相同地址
fmt.Println(xerrors.Is(xerrors.Opaque(err), ErrBase)) // 解除关系链之后无法确定关系
fmt.Println(xerrors.Unwrap(err) == ErrBase) // 获取内层错误为原错误,地址相同
}
输出结果为:
true
false
true
false
false
true
即便是在包裹多层之后,错误类型也能通过Is
方法正确识别:
func main() {
err := xerrors.Errorf("raiseError: %w", ErrBase)
err2 := xerrors.Errorf("wrap#01: %w", err)
err3 := xerrors.Errorf("wrap#02: %w", err2)
fmt.Println(xerrors.Is(err, ErrBase))
fmt.Println(xerrors.Is(err3, ErrBase)) // 能够正确识别关系,打印为true
}
如果需要打印详细的调用链路,则可以通过标准库fmt
相关功能进行输出,比如Printf
或者Sprintf
等。
func main() {
err := xerrors.Errorf("raiseError: %w", ErrBase)
err2 := xerrors.Errorf("wrap#01: %w", err)
err3 := xerrors.Errorf("wrap#02: %w", err2)
fmt.Printf("%+v\n", err3)
}
输出链路如下:
wrap#02:
main.main
/.../error.go:16
- wrap#01:
main.main
/.../error.go:15
- raiseError:
main.main
/.../error.go:14
- a new error:
main.init
/.../error.go:10
但是注意,使用%w
进行包装时,仅能单次包装单个错误,比如下面这种两个错误同时包装时,是会无法识别的:
var (
ErrBase = xerrors.New("a new error")
ErrBase2 = xerrors.New("another new error")
)
func main() {
err := xerrors.Errorf("raiseError: %w, %w", ErrBase2, ErrBase2)
fmt.Println(xerrors.Is(err, ErrBase))
fmt.Println(xerrors.Is(err, ErrBase2))
}
落地使用
在具体项目实现中,如对外提供的库文件中,我建议可以参考其他语言的实现方式,定义一个特殊的基础错误类型ErrBase
,所有其他错误类型均由此类型派生,则后续外部在使用过程中,只需通过xerros.Is
判定错误类型,则可以快速判定错误是否来自于本包,并且可以借助此功能统一单独处理来自于此第三方包的异常。
如果你有其他的建议和疑问,也欢迎在留言区中留言讨论。另外,根据实际实现代码来看,其中还有一些边缘情况未考虑或者未做处理,由于是试验性库,本库在使用过程中需自行承担所带来的风险。