前言

最近在对极客时间毛剑老师的 Go 进阶训练营进行重温和学习汇总，这是一门比较偏向于工程化以及原理层面的的课程，涵盖的知识点非常多，因此决定开一个系列来进行记录，也便于自己总结查阅。

Go 错误处理机制

Go 内置 errors

error
// http://golang.org/pkg/builtin/#error
// error 接口的定义
type error interface {
    Error() string
}
// http://golang.org/pkg/errors/error.go
// errors 构建 error 对象
type errorString struct {
    s string
}
func (e *errorString) Error() string {
    return e.s
}
errorError: EOFerrors.New()errorString

Error 与 Exception

不同于 Java、C++ 等语言，Go 处理异常的逻辑是不引入 exception，而是采取多参数返回，因此可以在函数中带入 error interface 对象来交给调用者来进行处理。

func handle() (int, error) {
    return 1, nil
}
func main() {
    i, err := handle()
    if err != nil {
        return
    }
    // 其他处理逻辑
}
try...exception...

Go 的多返回值来支持调用者进行错误处理的方式给予了开发者很大的灵活性，有如下优势

  • 简单
  • Plan for failure, not success
  • 没有隐藏的控制流
  • 完全交给开发者来控制 error
  • error 是值，因此有很大的灵活性进行处理

Go 错误处理最佳实践

panic

panic 只用于真正异常的情况，如

  • 在程序启动的时候，如果有强依赖的服务出现故障时 panic 退出
  • 在程序启动的时候，如果发现有配置明显不符合要求， 可以 panic 退出（防御编程）
  • 在程序入口处，例如 gin 中间件需要使用 recovery 预防 panic 程序退出

因为 panic 会导致程序直接退出，而如果使用 recovery 进行处理的话性能不好且不可控。因此，其他情况下只要不是不可恢复的程序错误，都不应该直接 panic 应该返回 error，从而交给开发者。

error

github.com/pkg/errors
errorerrornilif err != nil
// 错误示例
func f() error {
    ans, err := someFunc()
    if err == nil {
        // 其他逻辑
    }
    return err
}
// 正确示例
func f() error {
    ans, err := someFunc()
    if err != nil {
        return err
    }
    // 其他逻辑
    return nil
}
errors.Newerrors.Errorf
func someFunc() error {
    res := anotherFunc()
    if res != true {
        errors.Errorf("结果错误，已尝试 %d 次", count)
    }
    // 其他逻辑
    return nil
}
errors.WithMessage
func someFunc() error {
    res, err := anotherFunc()
    if err != nil {
        return errors.WithMessage(err, "other information")
    }
}
errors.Wrap
func f() error {
    err := json.Unmashal(&a, data)
    if err != nil {
        return errors.Wrap(err, "other information")
    }
    // 其他逻辑
    return nil
}
errors.Is
func f() error {
    err := A()
    if errors.Is(err, io.EOF){
        return nil
    }
    // 其他逻辑
    return nil
}
errors.As
func f() error {
    err := A()
    var errA errorA
    if errors.As(err, &errA){
        // ...
    }
    // 其他逻辑
    return nil
}

对于业务中的错误（如输入错误等），最好在统一的一个地方建立自己的错误字典，其中应该包含错误代码并且可以在日志中作为独立字段打印，也需要有清晰的文档。

我们常常用日志来辅助我们进行错误处理，不需要进行返回、被忽略的错误必须输出日志，但禁止每个出错的地方都打日志。而如果同一个地方不停地报错，最好是打印一次错误详情并打印出现次数。

总结

以上就是对 Go 错误处理和最佳实践的一些总结，后续也会对错误类型、错误包装以及常见的使用中遇到的坑等进行总结。

参考 golang gorm错误处理事务以及日志用法示例