如何解决:http2: Transport received Server‘s graceful shutdown GOAWAY

有一次做压力测试,客户端经常出现如下错误:

复制代码
http2: Transport: cannot retry err [http2: Transport received Server's graceful shutdown GOAWAY] after Request.Body was written; define Request.GetBody to avoid this error

是 Golang 中使用 HTTP/2 协议时,客户端收到服务端的 GOAWAY 信号(表示服务端准备关闭连接)时发生的错误。

错误含义简要解释:

  • GOAWAY 是 HTTP/2 协议中的一个信号,表示服务端打算关闭连接。
  • Golang HTTP 客户端如果在连接被关闭时还打算重试请求,而请求已经包含了 Body,就必须有办法重新读取请求体。
  • 如果没有为 Request.Body 定义 GetBody 方法,那么 Golang 无法重新读取请求体,自然也就无法重试。

解决方案

✅ 方案一:为请求显式设置 GetBody 字段

如果你手动构造了 http.Request 对象并包含了 Body,就应该设置 GetBody,示例如下:

go 复制代码
body := []byte("your request body here")
req, err := http.NewRequest("POST", url, bytes.NewReader(body))
if err != nil {
    // handle error
}

req.GetBody = func() (io.ReadCloser, error) {
    return io.NopCloser(bytes.NewReader(body)), nil
}

这样,如果连接重试时 Golang 可以重新从 GetBody() 获取请求体。


✅ 方案二:使用 http.Client 重试逻辑时避免重试不可重读的请求体

例如上传文件、流式数据时不要依赖 Golang 自动重试,可以改为手动管理连接、错误捕获和重试逻辑。


✅ 方案三:禁用 HTTP/2(仅作为最后手段)

如果你确定服务端的 HTTP/2 实现有问题,或者你不依赖 HTTP/2,可以选择禁用它:

go 复制代码
tr := &http.Transport{
    TLSNextProto: make(map[string]func(string, *tls.Conn) http.RoundTripper),
}
client := &http.Client{Transport: tr}

但一般不推荐,除非你知道自己在做什么。


总结

如果你遇到这个错误,大概率是你构造了带 Body 的请求,但是没有设置 GetBody。设置好它即可解决该问题。

如果你愿意贴一下你的请求代码,我可以帮你具体改一下。

相关推荐
nice_lcj5206 小时前
【从零理解计算机网络 · 15】完整串联:一次请求的全旅程,以及那道经典面试题
网络·计算机网络·http·面试·tcp·总结·网络排查
xbzb6 小时前
用 Secret + ConfigMap + PV/PVC 部署 WordPress:一套能跑 https 的最小组合
http·https·wordpress·configmap·secret·pod
code2cat1 天前
【随笔】Java客户端选了HTTP/3,怎样知道请求实际走了哪个版本
java·开发语言·http
SemiTris1 天前
Web 前端底层起源:HTML/CSS/JS、浏览器与 HTTP 完整脉络
http·html
修仙之路1 天前
2.1 HTTP 协议核心:请求响应模型、状态码、Header 与 RESTful 设计
网络协议·http
Flynn Liang2 天前
流量治理不是限流那么简单:I/O 密集型 Java 服务的 6 层防线
java·微服务·高并发·限流·熔断·系统稳定性·resilience4j
Flynn Liang3 天前
HikariCP 连接池不是越大越好:I/O 密集型 Java 服务的数据库容量工程
java·数据库·mysql·高并发·连接池·hikaricp·sql 优化
程序员韩星4 天前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Flynn Liang4 天前
Java 虚拟线程别乱用:I/O 密集型服务的线程模型与并发度计算
java·spring boot·性能优化·高并发·线程池·虚拟线程
Flynn Liang5 天前
I/O 密集型高并发实战:Java 服务 10 维优化,从线程打满到 10 万 QPS
java·spring boot·性能优化·高并发·系统设计·虚拟线程·io密集型