Golang 一个支持错误堆栈, 错误码, 错误链的工具库-Toy模板网

这篇具有很好参考价值的文章主要介绍了Golang 一个支持错误堆栈, 错误码, 错误链的工具库。希望对大家有所帮助。如果存在错误或未考虑完全的地方，请大家不吝赐教，您也可以点击"举报违法"按钮提交疑问。

介绍

来腾讯之后主要使用go, 在业务开发中需要一个支持错误码对外返回, 堆栈打印等能力的错误工具库, 先开始使用pkg/errors, 但该项目已经只读, 上次更新是几年前, 而且有一些点比如调整堆栈深度等没有支持, 后续根据业务的需要抽取了一个通用库, 且做了一些优化, 详见下方.

地址: https://github.com/morrisxyang/errors
如果觉得有用欢迎 Star 和 PR, 有问题请直接提issue

errors

Golang 一个支持错误堆栈, 错误码, 错误链的工具库

简单的支持错误堆栈, 错误码, 错误链的工具库:

支持携带堆栈, 嵌套构造错误链
支持携带错误码, 方便接口返回
支持自定义堆栈打印深度和错误链打印格式
使用 CallersFrames 替代 FuncForPC 生成堆栈, 避免特殊情况line number错误等问题, 详见runtime: strongly encourage using CallersFrames over FuncForPC with Callers result
简化堆栈信息, 一条链路多次Wrap操作只保留最深层堆栈, 只打印一次

安装和文档

安装使用 go get github.com/morrisxyang/errors

文档地址是 https://pkg.go.dev/github.com/morrisxyang/errors

快速开始

构造错误链

func a() error {
   err := b()
   err = Wrap(err, "a failed reason")
   return err
}

func b() error {
   err := c()
   err = Wrap(err, "b failed reason")
   return err
}

func c() error {
   _, err := os.Open("test")
   if err != nil {
      return WrapWithCode(err, 123, "c failed reason")
   }
   return nil
}

打印错误信息, %+v会打印堆栈, %v只打印错误信息

a failed reason
Caused by: b failed reason
Caused by: 123, c failed reason
Caused by: open test: no such file or directory
github.com/morrisxyang/errors.c
   /Users/morrisyang/Nutstore Files/go-proj/githuberrors/errors_test.go:94
github.com/morrisxyang/errors.b
   /Users/morrisyang/Nutstore Files/go-proj/githuberrors/errors_test.go:86
github.com/morrisxyang/errors.a
   /Users/morrisyang/Nutstore Files/go-proj/githuberrors/errors_test.go:80
....堆栈信息省略

核心方法

错误封装

func New(msg string) error
func Newf(format string, args …interface{}) error
func NewWithCode(code int, msg string) error
func NewWithCodef(code int, format string, args …interface{}) error
func Wrap(e error, msg string) error
func Wrapf(e error, format string, args …interface{}) error
func WrapWithCode(e error, code int, msg string) error
func WrapWithCodef(e error, code int, format string, args …interface{}) error

错误解析

func Code(e error) int
func EffectiveCode(e error) int
func Msg(e error) string
func As(err error, target interface{}) bool
func Is(err, target error) bool
func Cause(e error) error
func Unwrap(err error) error

配置

type Config
- func GetCfg() *Config
func ResetCfg()
func SetCfg(c *Config)

FAQ

多次 Wrap 错误会携带多次堆栈吗?

可在调用链路上多次Wrap, 添加说明信息, 但只有最深层的Wrap操作会设置堆栈, 继续 Wrap, return err 等操作不会影响堆栈信息
在链路中某个错误设置了合适的错误码, 然后继续Wrap时没有设置, 如何获取?

建议在合适的清晰的时机设置有效的错误码, 可以使用EffectiveCode获取链路中外层第一个有效的非0错误码, 由于系统调用等情况, 同一链路中可能有多个错误携带错误码, 此时默认外层的错误码应该对外暴露, 屏蔽了内层的详细信息.文章来源地址https://www.toymoban.com/news/detail-509098.html

到了这里，关于Golang 一个支持错误堆栈, 错误码, 错误链的工具库的文章就介绍完了。如果您还想了解更多内容，请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章，希望大家以后多多支持TOY模板网！