Featured image of post 聊聊新的Go语言错误处理方案

聊聊新的Go语言错误处理方案

今天早些时候,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判定错误类型,则可以快速判定错误是否来自于本包,并且可以借助此功能统一单独处理来自于此第三方包的异常。

如果你有其他的建议和疑问,也欢迎在留言区中留言讨论。另外,根据实际实现代码来看,其中还有一些边缘情况未考虑或者未做处理,由于是试验性库,本库在使用过程中需自行承担所带来的风险。

Licensed under CC BY-NC-SA 4.0
Built with Hugo
主题 StackJimmy 设计