Go 为什么 io.ReadAll 读不到已经读取过的请求体

在 Go 的 HTTP Handler 里，io.ReadAll(r.Body) 第一次能读到 JSON，到了后面的校验函数却变成空字节，这是很典型的“请求体已经被消费”问题。io.ReadAll 不会保存一个可以反复读取的副本，它只会从当前读取位置继续读到 EOF。前置中间件、r.ParseForm()、JSON 解码器或日志代码只要先读过一次，后面的读取就可能只得到空结果。

根本原因是`http.Request`里的Body字段实现了`io.Reader`接口，属于单向流读取的设计，流读取过之后内部的游标位置已经走到了末尾，没有重复重置游标的话，后续再调用任何读取方法包括`io.ReadAll`，都会直接返回EOF空结果。

为什么第一次能读，第二次只剩 EOF

服务端的 Request.Body 实现的是 io.ReadCloser。它代表当前 HTTP 请求的输入流，不是一个自动保存位置的字符串。io.ReadAll 的语义是从传入 Reader 的当前位置读取，直到遇到 EOF，然后返回已经读到的字节。

因此下面的代码中，第二次调用面对的是同一个已经到达末尾的 Reader：

func handler(w http.ResponseWriter, r *http.Request) {
	// 第一个消费者把 Body 从当前位置读到 EOF。
	first, err := io.ReadAll(r.Body)
	if err != nil {
		http.Error(w, "读取请求体失败", http.StatusBadRequest)
		return
	}

	// 第二次没有新的输入可读，通常得到空切片。
	second, err := io.ReadAll(r.Body)
	if err != nil {
		http.Error(w, "再次读取请求体失败", http.StatusBadRequest)
		return
	}

	log.Printf("first=%d second=%d", len(first), len(second))
	w.WriteHeader(http.StatusNoContent)
}

这里的问题不在 io.ReadAll 失效，而在于两个调用共享同一个读取游标。若请求本身没有 body，服务端的 Body 也会立即返回 EOF；这和 body 已经被前置代码读完，在字节长度上可能表现得一样。

先找出谁把 Body 读空了

排查时不要先改 JSON 字段或 Content-Type。先沿着 Handler 的调用链找所有可能读取 r.Body 的位置，尤其是认证中间件、签名校验、请求日志、表单解析和 json.Decoder.Decode。它们可能没有显式调用 io.ReadAll，但仍然会从同一条流中取走字节。

如果前置环节使用了 json.Decoder，不要在后面假设还可以从原始 Body 重新解码。解码器同样依赖 Reader 的当前位置；要复用原始 JSON，应当在最早的读取点保存字节。

一次缓存，让校验和业务共享请求数据

最稳妥的处理方式是把 Body 读成一份受控的字节切片，然后让后续逻辑直接使用这份切片，或者从它创建新的 Reader。下面的示例把原始内容交给签名检查，再交给 JSON 解码，两个环节不再争用网络流。

func handler(w http.ResponseWriter, r *http.Request) {
	// 先限制输入规模，避免无上限地把请求体放进内存。
	r.Body = http.MaxBytesReader(w, r.Body, 1

如果下游接口只接受 io.Reader，直接传 bytes.NewReader(raw)；如果它依赖 r.Body 这个字段，就重新赋值为 io.NopCloser(bytes.NewReader(raw))。不要把 Request.GetBody 当成服务端重读开关：它主要服务于客户端重定向，服务端请求不靠它生成副本。

几个容易混淆的边界

空请求体不等于读取失败。读取成功且长度为 0，可能只是发送端没有内容；读取错误则应保留原始错误并按请求处理策略返回。重复读取不等于重复请求。重置 Body 只是让本次请求拥有新的内存 Reader，不会从客户端重新拉取网络数据。不要让每层都自行缓存。最好由入口层确定最大长度、完成一次读取，再把不可变的字节副本传给需要它的函数。

最后可以按这张清单复查：谁第一次读了 Body？是否读到了 EOF？是否有 Close 提前发生？是否真的需要多个消费者？如果需要，缓存是否有上限，重置后的 Reader 是否只服务于本次请求？这些问题能把“io.ReadAll 读不到”从模糊现象缩小到具体调用点。

相关问题

为什么第二次 io.ReadAll 没有报错却返回空切片？

因为 Reader 已经在末尾，正常 EOF 会被 io.ReadAll 转换为成功返回，空切片只说明当前位置没有剩余字节。

重置 r.Body 后可以无限次读取吗？

可以重新创建多个内存 Reader，但每份数据都会占用内存；应限制请求体大小，并避免在多个层级重复复制。

用 json.Decoder 解码后还能读取原始 JSON 吗？

不能指望从原来的 Reader 恢复。若还需要原文，应先缓存字节，或在第一次读取时把原始数据同时交给需要它的环节。