错误堆栈

示例：

可以看到，调用端可以通过Wrap方法将底层的错误信息进行层级叠加，并且包含完整的错误堆栈信息。

HasStack 判断错误是否带堆栈

• 说明：通过HasStack方法我们可以判断给定的error接口对象是否实现（包含）了堆栈信息。

• 格式：

  HasStack(err error) bool

• func ExampleHasStack() {
      err1 := errors.New("sql error")
      err2 := gerror.New("write error")
      fmt.Println(gerror.HasStack(err1))
      fmt.Println(gerror.HasStack(err2))
      // Output:
      // false
      // true
  }

Stack 获取堆栈信息

• 说明：通过Stack方法我们可以获得error对象的完整堆栈信息，返回堆栈列表字符串。 注意参数为标准库error类型，当该参数为gerror模块生成的error时， 或者开发者自定义的error对象实现了该接口时支持打印，否则，返回空字符串。

• 格式：

  Stack(err error) string

• 示例：

获取当前error

• 说明：Current方法用于获取当前层级的错误信息，通过error接口对象返回。

• 格式：

  Current(err error) error

•       var err error
      err = errors.New("sql error")
      err = gerror.Wrap(err, "adding failed")
      err = gerror.Wrap(err, "api calling failed")
      fmt.Println(err)
      fmt.Println(gerror.Current(err))
      // Output:
      // api calling failed: adding failed: sql error
      // api calling failed
  }

Next/Unwrap 获取下一层error

• 说明：Next/Unwrap方法用于获取层级错误的下一级错误error接口对象。当下一层级不存在时，返回nil。其中Unwrap方法是Next方法的别名，是Golang v1.17版本开始支持的错误堆栈遍历方法。

• 格式：

  Next(err error) error

• 示例1：简单的错误层级访问示例。

• 示例2：常见遍历逻辑代码示例。

  func IsGrpcErrorNotFound(err error) bool {
      if err != nil {
          for e := err; e != nil; e = gerror.Unwrap(e) {
              if s, ok := status.FromError(e); ok && s != nil && s.Code() == codes.NotFound {
                  return true
              }
          }
      }
      return false
  

Cause 获取根错误error

• 说明：通过Cause方法我们可以获得error对象的根错误信息（原始错误）。 注意参数为标准库error类型，当该参数为gerror模块生成的error时， 或者开发者自定义的error对象实现了该接口方法时支持打印，否则，返回输出的error对象。

• 示例：

  package main
  import (
      "fmt"
      "github.com/gogf/gf/v2/errors/gerror"
  )
  func OpenFile() error {
      return gerror.New("permission denied")
  }
  func OpenConfig() error {
      return gerror.Wrap(OpenFile(), "configuration file opening failed")
  }
  func ReadConfig() error {
      return gerror.Wrap(OpenConfig(), "reading configuration failed")
  }
  func main() {
      fmt.Println(gerror.Cause(ReadConfig()))
  }
  // Output: