net/http 客户端关闭连接后请求体重用的限制

在 Go 的 net/http 客户端里，关闭请求体不会把它重置到开头，也不会让同一个 *http.Request 自动变成可再次发送的对象。Client.Do 会让底层 Transport 负责关闭非空的请求体；如果后续需要重试、重新提交或跟随 307/308 重定向，就必须有一份可以重新创建的原始数据，或者给请求提供能返回新读取器的 GetBody。

最容易混淆的三件事是：Request.Body.Close() 结束的是请求体读取资源，Request.Close 控制的是 TCP 连接是否复用，Response.Body.Close() 影响的是响应连接能否回到 keep-alive 池。它们都不会把已消费的请求体倒带。

官方资料入口：https://pkg.go.dev/net/http。下面按对象边界、重建方式和实际工作流拆开说明。

先区分请求体、响应体和 TCP 连接

一次客户端调用至少涉及三层资源。Request.Body 是发送给服务端的输入流；它被读完或被 Transport 关闭后，通常不能再从同一个读取器获得原始字节。Response.Body 是服务端返回的输出流，读取到 EOF 并关闭后，Transport 才更有机会复用底层持久连接。TCP 连接本身则由 Transport 管理，是否复用与请求体能否重读是两个不同问题。

Request.Close = true 只表示本次客户端请求结束后不要在相同主机之间复用 TCP 连接，不能替代重新创建 Request.Body。如果只是想把请求体再次发送，修改这个字段没有帮助。

理解 Client.Do 对请求体的关闭语义

http.NewRequest 接收的是 io.Reader，而客户端发送时需要一个可读的请求体。官方文档说明：如果提供的 Body 同时实现了 io.Closer，Client 方法或 Transport 会负责关闭它，而且这个关闭动作可能在 Do 返回后异步发生。因此，调用方不要把“Do 返回了”理解成 Body 仍然处于可读状态。

响应也有一条独立的规则：Do 成功时返回的 Response.Body 非空，调用方应当读取并关闭它。只关闭响应体而不重新创建请求体，不能解决重试时的 EOF；只重建请求体而不关闭响应体，又可能让连接无法正常复用。

func sendOnce(client *http.Client, payload []byte) error {
	// bytes.Reader 只提供本次请求需要的读取视图，原始 payload 仍由调用方保存。
	req, err := http.NewRequest(http.MethodPost, "https://api.example.test/items", bytes.NewReader(payload))
	if err != nil {
		return err
	}
	req.Header.Set("Content-Type", "application/json")

	resp, err := client.Do(req)
	if err != nil {
		// 请求体由 Transport 负责关闭，这里不要把 req 当成可直接复用的请求。
		return err
	}
	defer resp.Body.Close()
	// 读取响应到 EOF，有助于 Transport 判断连接是否可以继续复用。
	_, err = io.Copy(io.Discard, resp.Body)
	return err
}

请求体为什么不能天然重用

io.Reader 描述的是“继续读取当前位置的数据”，不是“保存一份可无限复制的字节数组”。例如一个 *bytes.Reader 被读到末尾后，游标已经移动；对它执行 Close 也不存在把游标恢复到零的位置。被 io.NopCloser 包装后，读取状态仍然只有一份。

因此，下面这种写法虽然看起来像是“发送两次同一个请求”，第二次实际面对的是已经被消费或关闭的 Body：

func wrongReuse(client *http.Client, req *http.Request) error {
	// 第一次 Do 会消费请求体，Transport 也会负责关闭它。
	if _, err := client.Do(req); err != nil {
		return err
	}
	// 重新调用 Do 不会自动把 req.Body 倒带，可能得到空请求体或读取错误。
	_, err := client.Do(req)
	return err
}

Request.Clone 也不是通用的 Body 重置方案。官方文档明确指出，Clone 对 Body 只做浅复制；复制出的请求仍然指向同一个读取资源。需要重试时，应复制原始字节或让工厂函数重新构造一个新的 Request。

用 GetBody 判断请求能否重建

Request.GetBody 是一个可选函数，作用是返回 Body 的新副本。它主要用于客户端需要多次读取请求体的场景。对于 307 和 308 重定向，Client 会保留原方法和请求体，但前提是 GetBody 已定义。

使用 http.NewRequest 或 NewRequestWithContext 时，如果传入的 body 具体类型是 *bytes.Buffer、*bytes.Reader 或 *strings.Reader，标准库会设置精确的 ContentLength，并自动填充 GetBody。反过来，如果把 Reader 过早包装成一个普通的 io.ReadCloser，这个类型信息就不再能被 NewRequest 用来自动构造 GetBody。

为重试代码保存原始数据并重新创建 Request

最容易维护的做法是把“请求参数”与“请求对象”分开：原始 JSON、表单字节或文件内容由调用方保存，每一次尝试都调用工厂函数创建新的 Request。这样即使上一轮的 Body 已关闭，也不会影响下一轮。

func newJSONRequest(ctx context.Context, endpoint string, payload []byte) (*http.Request, error) {
	// 每次调用都创建新的 Reader，避免复用上一次发送后的游标。
	req, err := http.NewRequestWithContext(ctx, http.MethodPost, endpoint, bytes.NewReader(payload))
	if err != nil {
		return nil, err
	}
	// bytes.Reader 让 NewRequestWithContext 可以为重定向准备 GetBody。
	req.Header.Set("Content-Type", "application/json")
	return req, nil
}

func postWithRetry(ctx context.Context, client *http.Client, endpoint string, payload []byte) ([]byte, error) {
	for attempt := 0; attempt = 500 && attempt == 0 {
			// 服务端暂时失败时，下一轮会使用同一份原始 payload 创建新 Body。
			continue
		}
		return body, nil
	}
	return nil, fmt.Errorf("request retry exhausted")
}

这个模式的关键不是“关闭后再打开”，而是让每次发送都有新的读取器。若 payload 很大，不适合全部放入内存，就要改用可重新打开的文件、分块上传协议，或显式实现一个能够返回新流的 Body 工厂。

按场景处理重定向、流式上传和响应复用

307/308 重定向：它们保留原 HTTP 方法和请求体，Client 只有在 GetBody 存在时才有条件重放。使用 bytes.Reader 等标准 Reader 构造请求通常更省心；如果 Body 来自管道、实时压缩器或网络流，就不能假设重定向可以自动完成。

流式上传：流式 Body 的价值是边读边发，但它通常不可回放。此时更应在业务层决定是否允许重试，并在协议层使用分片、上传会话或幂等键，不能仅靠 Request.Clone 复制。

响应体：如果只关心状态码，也应尽快关闭 Response.Body；如果希望 Transport 尽量复用连接，通常还要把响应读到 EOF。响应体的关闭与请求体重建相互独立，两个动作都不能省略。

Request.Close：只有在确实需要禁止连接复用时才设置。它解决的是连接生命周期策略，不是请求数据重试策略。

一套可复用的判断顺序

1. 先问请求是否会被第二次发送：没有重试、重定向或重复提交需求时，不必额外设置 GetBody。
2. 再确认 Body 的来源：内存字节、字符串和可定位文件通常可以重新创建；实时流、管道和已消费的网络流通常不能回放。
3. 如果使用标准 Reader 构造请求，检查 req.GetBody != nil；它只说明标准库有重建函数，不代表业务重试一定安全。
4. 重试时创建新的 Request，并为每次响应执行读取与关闭；不要把关闭 TCP 连接当成数据恢复手段。
5. 对非幂等 POST 还要结合服务端幂等键、去重策略和重试条件，避免请求虽然能重放，却造成重复业务副作用。

常见问题与速查表

记住一句话即可：Body.Close 负责结束这一次读取，GetBody 负责提供下一份读取器，Transport 负责连接管理。把原始请求数据保存下来，并在每次重试时重新构造 Request，才是 net/http 客户端请求体可控重用的边界。