error 接口

Go 语言中把错误当成一种特殊的值来处理，不支持其他语言中使用try/catch捕获异常的方式。

Error 接口

Go 语言中使用一个名为error接口来表示错误类型。

type error interface {
	Error() string
}

error接口只包含一个方法——Error，这个函数需要返回一个描述错误信息的字符串。

当一个函数或方法需要返回错误时，我们通常是把错误作为最后一个返回值。例如下面标准库 os 中打开文件的函数。

func Open(name string) (*File, error) {
	return OpenFile(name, O_RDONLY, 0)
}

由于error是一个接口类型，默认零值为nil。所以我们通常将调用函数返回的错误与 nil 进行比较，以此来判断函数是否返回错误。例如你会经常看到类似下面的错误判断代码。

file, err := os.Open("./xx.go")
if err != nil {
	fmt.Println("打开文件失败,err:", err)
	return
}

当我们使用fmt包打印错误时会自动调用 error 类型的 Error 方法，也就是会打印出错误的描述信息。

创建错误

我们可以根据需求自定义 error，最简单的方式是使用errors包提供的New函数创建一个错误。

errors.New

函数签名如下，

func New(text string) error

它接收一个字符串参数返回包含该字符串的错误。我们可以在函数返回时快速创建一个错误。

func queryById(id int64) (*Info, error) {
	if id <= 0 {
		return nil, errors.New("无效的 id")
	}

	// ...
}

或者用来定义一个错误变量，例如标准库 io.EOF 错误定义如下。

var EOF = errors.New("EOF")

fmt.Errorf

当我们需要传入格式化的错误描述信息时，使用fmt.Errorf是个更好的选择。

fmt.Errorf("查询数据库失败，err:%v", err)

但是上面的方式会丢失原有的错误类型，只拿到错误描述的文本信息。

为了不丢失函数调用的错误链，使用fmt.Errorf时搭配使用特殊的格式化动词%w，可以实现基于已有的错误再包装得到一个新的错误。

fmt.Errorf("查询数据库失败，err:%w", err)

对于这种二次包装的错误，errors 包中提供了以下三个方法。

func Unwrap(err error) error                 // 获得 err 包含下一层错误
func Is(err, target error) bool              // 判断 err 是否包含 target
func As(err error, target interface{}) bool  // 判断 err 是否为 target 类型

错误结构体类型

此外我们还可以自己定义结构体类型，实现error接口。

// OpError 自定义结构体类型
type OpError struct {
	Op string
}

// Error OpError 类型实现 error 接口
func (e *OpError) Error() string {
	return fmt.Sprintf("无权执行%s 操作", e.Op)
}