https://github.com/morrisxyang/errors
在业务开发中需要一个支持错误码对外返回, 堆栈打印等能力的错误工具库, 先开始使用 pkg/errors, 但该项目已经只读, 上次更新是几年前, 而且有一些点比如调整堆栈打印深度, 打印格式等能力没有支持, 后续根据业务的需要抽取了一个通用库, 做了一些优化, 详见下方.
如果觉得有用欢迎 Star 和 PR, 有问题请直接提 issue
简单的支持错误堆栈, 错误码, 错误链的工具库:
支持携带堆栈, 嵌套构造错误链
支持携带错误码, 方便接口返回
支持自定义堆栈打印深度和错误链打印格式
使用 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
....堆栈信息省略
多次 Wrap 错误会携带多次堆栈吗?
可在调用链路上多次 Wrap, 添加说明信息, 但只有最深层的 Wrap 操作会设置堆栈, 继续 Wrap
, return err
等操作不会影响堆栈信息
在链路中某个错误设置了合适的错误码, 然后继续 Wrap 时没有设置, 如何获取?
建议在合适的清晰的时机设置有效的错误码, 可以使用EffectiveCode
获取链路中外层第一个有效的非 0 错误码, 由于系统调用等情况, 同一链路中可能有多个错误携带错误码, 此时默认外层的错误码应该对外暴露, 屏蔽了内层的详细信息.
1
tairan2006 2023-07-11 17:49:23 +08:00
标准库里面内置的就有 errors 啊
|
2
atVoid OP @tairan2006
标准库的 errors 没有堆栈, 这里主要是增加了堆栈, 以及微服务常用的错误码等支持 |
3
tairan2006 2023-07-13 16:22:19 +08:00 1
@atVoid #2 我的意思是,你的包名能不能换一个…
|
4
atVoid OP @tairan2006 啊, 确实, 我知道了. 我想想
|