这是一个创建于 1401 天前的主题，其中的信息可能已经有所发展或是发生改变。
和大家分享一个自己写的库 github.com/gota33/errors
主要用于结构化 error 的生成、编码和解码。目前自用下来还可以，欢迎试用及提出建议。
错误的描述信息是遵循 Google API design 设计的。
这里贴一个输出到控制台的例子，当然也是可以编码成 JSON 在 RESTful 服务间传递的。
更多的例子可以参考项目首页的文档。
// ... err := Annotate( context.DeadlineExceeded, DeadlineExceeded, StackTrace("heavy job"), RequestInfo{RequestId: "<uuid>"}, LocalizedMessage{Local: "en-US", Message: "Background task timeout"}, LocalizedMessage{Local: "zh-CN", Message: "后台任务超时"}, ) fmt.Printf("%+v", err) // Output: // status: "504 DEADLINE_EXCEEDED" // message: "context deadline exceeded" // detail[0]: // type: "type.googleapis.com/google.rpc.DebugInfo" // detail: "heavy job" // stack: // goroutine 1 [running]: // runtime/debug.Stack(0xc00005e980, 0x40, 0x40) // /home/user/go/src/runtime/debug/stack.go:24 +0xa5 // github.com/gota33/errors.StackTrace.Annotate(0xfe36af, 0x9, 0x1056490, 0xc00005e980) // /home/user/github/gota33/errors/detail.go:368 +0x2d // github.com/gota33/errors.Annotate(0x1051780, 0x1257e60, 0xc00010fc00, 0x5, 0x5, 0xc00010fba8, 0x10) // /home/user/github/gota33/errors/errors.go:79 +0x97 // github.com/gota33/errors.ExampleAnnotate() // /home/user/github/gota33/errors/example_test.go:10 +0x251 // testing.runExample(0xfe589a, 0xf, 0xfff6c0, 0xfead08, 0x1a, 0x0, 0x0) // /home/user/go/src/testing/run_example.go:63 +0x222 // testing.runExamples(0xc00010fed0, 0x120aee0, 0x3, 0x3, 0x0) // /home/user/go/src/testing/example.go:44 +0x185 // testing.(*M).Run(0xc000114100, 0x0) // /home/user/go/src/testing/testing.go:1419 +0x27d // main.main() // _testmain.go:71 +0x145 // // detail[1]: // type: "type.googleapis.com/google.rpc.RequestInfo" // request_id: "<uuid>" // serving_data: "" // detail[2]: // type: "type.googleapis.com/google.rpc.LocalizedMessage" // local: "en-US" // message: "Background task timeout" // detail[3]: // type: "type.googleapis.com/google.rpc.LocalizedMessage" // local: "zh-CN" // message: "后台任务超时" 第 1 条附言 2021-12-18 13:54:26 +08:00
如果想了解错误结构设计的思路，可以先看一下 Google API Design 的文档： https://cloud.google.com/apis/design/errors 。
 | 1 godlovesxcjtest 2021-12-17 22:14:28 +08:00 挺好的，但是，老哥你不觉得这样处理错误太麻烦了吗。要写好多，go 语言的错误处理本来就麻烦的有要死，如果按照你这种用法，岂不是处理错误的代码都要写好多 |
 | 2 Gota OP @godlovesxcjtest 谢谢评价。 这个库主要在微服务的场景下使用。这时候需要考虑到错误的传递，比如不同的 status code 和 http code ，以及不同的错误类型需要有不同的 payload 来描述错误细节，再如 request_id 这样的字段。 当然简单的用法也有，比如只附加 status code 而不加具体的 detail ，但这里为了演示就把所有的字段都加上了。 |
| 3 godlovesxcjtest 2021-12-17 22:57:38 +08:00 @Gota request_id 没必要放到 error 里面。可以放到 context 里面，打印日志的时候，传入 context ，这样每条日志都可以有 request_id 。 我没仔细看源码，想问一下，底层使用你的库抛出错误后，调用的上层想加上一些错误信息，类似 errors.Withmessage 这种，使用什么方法，上层是不是还需要加上错误吗呢 |
| 4 Gota OP @godlovesxcjtest 是这样的，由于服务之间传递错误需要一个固定的格式，所以这里采用的是 Google API design 里的建议格式。所以里面的 request_id 不是用来记录日志的，而是错误格式本身所定义的。 关于错误码，任意层级都是可以设置的，以最后设置的为准。如果是增加非结构化的错误信息可以直接用 fmt.Errorf()，如果是结构化错误信息就需要用 errors.Annotate() 了。 |
 | 5 eudore 2021-12-20 09:14:28 +08:00 我都直接 logger 把 error 发送到 jaeger 面板上去了。 |
Select Language