go-zero框架HttpCode 503错误与context canceled高相关性根因分析

这里是Z哥的个人公众号

当前处于不稳定更新状态

何时恢复周更，未知……

我的第「232」篇原创敬上

大家好，我是Z哥。

好久不见，我今天强行逼自己上岗，来更新一篇。

前阵子团队内备战双11的时候出现了一个问题：

当流量瞬时激增时，API会出现大量 HttpCode 为 503 的错误。与此同时，发现另一个错误 `responses.go:69 write response failed, error: context canceled` 与该错误具有很强的相关性。这 2 个错误都由我们使用的 go-zero 框架内部抛出。

后来我花费了16个小时来搞清楚这个事情，在这里分享给大家。

/01 结论先行/

我先讲结论：

以上 503 错误是由于客户端取消请求引发的，并非真正是 5xx 所定义的「服务端异常」相关的错误。前面提到的第 2 个错误就是表示「请求被取消」的意思。

go-zero 在 Dec 20, 2021 之后的版本（>= v1.2.5）中，增加了错误码 499（参考nginx 的状态码定义） 来专门表示这类错误，代替了原先的 503 错误码。

相关commit：https://github.com/zeromicro/go-zero/commit/4ba2ff7cdd34b73312f5ce17191068146bc676a0

由于我们项目中使用的版本为 v1.2.2 因此以错误码 503 输出。解决方式也很简单，升级 go-zero 的版本。

下面是整个长达16小时的分析的过程。除了你可以了解具体的根因外，也欢迎你和我分享当你遇到类似情况时好用、高效的排查思路。

/02 why？/

01 抛出日志的代码位置

首先，找到源码中两个错误抛出的代码位置。

以上输出错误日志的代码位置可以分析出场景为：

1. 往 Reponse 写入数据时发生了 context canceled 错误。

2. 并且 http code >= 500，则会记录error级别日志。以下是 isOkResponse 函数内的逻辑。

func isOkResponse(code int) bool {
   // not server error
   return