请求体重放

POST 请求第一次发送后，想把同一个 http.Request 再交给 Client.Do，经常会遇到请求体为空。关键不在于把 Body 再读一遍，而在于每次发送前都拿到一个全新的 io.ReadCloser。Request.GetBody 只是“如何创建副本”的可选函数；它为空时，直接重试已经消耗过的 Body 自然只能读到 EOF。

Body 和 GetBody 不是同一个东西

Request.Body 是本次发送实际消费的流；Request.GetBody 则是一个可选工厂，调用后应返回新的 Body。官方定义还特别说明：它主要服务于客户端请求在重定向时重复读取请求体，且设置 GetBody 并不能省略 Body。服务器收到的请求不使用这个字段，所以不要在服务端 handler 里期待它替你保存原始请求体。

下面的判断可以直接放进重试策略中：先看请求能否产生新的 Body，再决定是否允许自动重试。

func canReplay(req *http.Request) bool {
	// GetBody 能创建独立读取流时，才具备请求体重放的基础。
	return req != nil && req.Body != nil && req.GetBody != nil
}

为什么 NewRequest 有时会自动填充 GetBody

用 http.NewRequest 创建客户端请求时，如果传入的 reader 类型是 *bytes.Buffer、*bytes.Reader 或 *strings.Reader，标准库可以记录长度并生成新的 reader，因此会填充 GetBody。如果传入的是一个普通的自定义 reader、管道或网络流，标准库无法猜测怎样重新产生数据，GetBody 通常就是 nil。

这里的“通常”是为了提醒你仍应检查实际值。不要把 ContentLength 非零误认为 Body 可以重放；长度只描述本次请求的大小，不会保存一份可重新读取的数据。

用请求体工厂为每次重试创建新 Request

更稳妥的做法是把“创建请求体”保存成函数。每次尝试都新建 Request，然后把新的 Body 交给客户端；这样不会让第二次尝试接着第一次的 EOF 继续读。

func newPost(url string, payload []byte) (*http.Request, error) {
	// 每次调用都从同一份不可变数据创建新的读取流。
	body := bytes.NewReader(payload)
	req, err := http.NewRequest(http.MethodPost, url, body)
	if err != nil {
		// URL 不合法时把创建错误交给上层，不进入重试循环。
		return nil, err
	}
	req.Header.Set("Content-Type", "application/json") // 标记请求体格式。
	return req, nil
}

func doWithRetry(client *http.Client, url string, payload []byte) (*http.Response, error) {
	for attempt := 0; attempt 

如果拿到了响应，不论状态码是否代表业务成功，都要在消费完响应体后关闭它：

resp, err := doWithRetry(client, target, payload)
if err != nil {
	// 网络错误没有可供读取的响应体，直接返回错误。
	return err
}
defer resp.Body.Close() // 读取成功响应后释放连接相关资源。

body, err := io.ReadAll(resp.Body)
if err != nil {
	// 响应已返回，但读取正文仍可能产生 I/O 错误。
	return err
}
fmt.Println(resp.StatusCode, string(body)) // 状态码和正文交给业务判断。

GetBody 为空时应该怎么选

小型 JSON 或表单可以在进入重试前保存为 []byte，像上面的工厂一样重复创建 reader。大文件更适合使用可重新打开的文件或记录偏移的位置；真正的一次性流、上传管道和带副作用的请求，则不应因为“网络错误”就默认重放。还要把服务端是否幂等、是否已经处理成功纳入判断，GetBody 只能解决数据能否再次读取，不能保证重复 POST 没有业务副作用。

常见问题

手动给 Body 重新赋值就能重试吗？

可以，但前提是你确实有一份可重新生成的数据；从已经读到 EOF 的同一个 reader 重新赋值没有意义。更推荐保存请求体工厂，让每次尝试都新建 Request。

GetBody 为空是不是请求创建失败？

不是。它是可选字段，说明标准库没有为当前 reader 自动提供副本工厂；只要你不依赖重定向或自动重试，普通请求仍然可以正常发送。

服务端 Request 也要设置 GetBody 吗？

不用。服务端请求的 GetBody 不参与重放；如果 handler 需要多次使用正文，应在读取时主动缓存并按业务限制大小。

小结

请求体重放的核心不是“把旧 Body 再读一次”，而是“为下一次发送创建新的 Body”。检查 GetBody 只能判断当前请求是否有现成工厂；面对普通流式 reader，保存原始数据或实现自己的工厂，再为每次尝试创建新的 POST Request。最后不要忘记关闭已经返回的响应体。