如何解决: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。设置好它即可解决该问题。

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

相关推荐
web前端神器1 天前
记录一下node后端写下载https的文件报错,而浏览器却可以下载。
网络协议·http·https
三项超标1 天前
AI入坑: Trae 通过http调用.net 开发的 mcp server
网络·网络协议·http
绵绵细雨中的乡音1 天前
HTTP 协议详解
网络·网络协议·http
JJ1M81 天前
http问题汇总
网络·网络协议·http
奋斗的老史1 天前
内网的应用系统间通信需要HTTPS吗
网络协议·http·https
数智顾问1 天前
Trae + MCP : 一键生成专业封面的高阶玩法——自定义插件、微服务编排与性能调优
网络·http·https
百思可瑞教育2 天前
前端性能优化:请求和响应优化(HTTP缓存与CDN缓存)
前端·网络协议·http·缓存·性能优化·北京百思可瑞教育·百思可瑞教育
宁小法2 天前
HTTPS -> HTTP 引起的 307 状态码与HSTS
网络协议·http·https
是店小二呀2 天前
【ProtoBuf 】C++ 网络通讯录开发实战:ProtoBuf 协议设计与 HTTP 服务实现
网络·c++·http·protobuf
URBBRGROUN4672 天前
Streamable HTTP
网络·网络协议·http