go 的 http 请求体默认只能读取一次，因其底层是 io.readcloser 而非 io.seeker；本文介绍使用 io.teereader 缓存并复用请求体的可靠方案，并提供可直接运行的示例代码与关键注意事项。
go 的 http 请求体默认只能读取一次，因其底层是 io.readcloser 而非 io.seeker；本文介绍使用 io.teereader 缓存并复用请求体的可靠方案，并提供可直接运行的示例代码与关键注意事项。
在 Go 的 HTTP 服务开发中，一个常见但易被忽视的陷阱是：*`http.Request.Body只能被完整读取一次**。这是因为其类型为io.ReadCloser，不支持Seek(0, 0)—— 即无法“倒带”重读。当你在多个 Handler 函数（如Method1和Method2）中先后调用json.NewDecoder(r.Body).Decode(...)时，第二次解码必然失败，返回EOF或io.ErrUnexpectedEOF` 错误。
根本原因在于：r.Body 在首次读取后已抵达流末尾，且底层 net.Conn 连接不会保留已传输的字节。因此，简单尝试 r.Body.Close() 后重新赋值无效，必须显式缓存原始字节。
✅ 推荐方案：io.TeeReader + 内存缓冲
最简洁、安全且符合 Go 惯用法的解决方案是：在首次读取时同步将字节写入内存缓冲区（如 bytes.Buffer），再将该缓冲区设为新的 r.Body。io.TeeReader 正是为此设计——它在读取源 io.Reader 的同时，将所有数据“镜像”写入一个 io.Writer：
func Method1(w http.ResponseWriter, r *http.Request) {
// 创建可重用的缓冲区
buf := &bytes.Buffer{}
// TeeReader：读 r.Body 的同时把数据拷贝进 buf
tee := io.TeeReader(r.Body, buf)
var postData database.User
if err := json.NewDecoder(tee).Decode(&postData); err != nil {
http.Error(w, "Invalid JSON: "+err.Error(), http.StatusBadRequest)
return
}
// 关键：替换 r.Body，使其后续可被再次读取
r.Body = io.NopCloser(buf)
}✅ 注意：io.NopCloser(buf) 将 *bytes.Buffer 包装为 io.ReadCloser，满足 r.Body 接口要求；buf 本身支持多次 Read()，无副作用。
? 复用示例：Method2 可直接调用
此时 Method2 无需任何修改即可正常工作：
func Method2(w http.ResponseWriter, r *http.Request) {
var postData database.User
if err := json.NewDecoder(r.Body).Decode(&postData); err != nil {
http.Error(w, "Failed to decode body (again): "+err.Error(), http.StatusBadRequest)
return
}
// ✅ 成功！postData 已正确解析
}⚠️ 重要注意事项
- 仅限小到中等请求体：bytes.Buffer 将全部请求体加载至内存，不适用于大文件上传（如 >10MB）。对大体积场景，应改用临时磁盘文件或流式预处理。
-
务必关闭原 r.Body：虽然 TeeReader 不会自动关闭 r.Body，但为防资源泄漏，建议在 Method1 开头显式调用 defer r.Body.Close()（注意：需在 r.Body = ... 前执行）：
defer r.Body.Close() // 在替换前关闭原始 Body
- 避免竞态：若 Handler 并发调用（如中间件链中），需确保 r.Body 替换是线程安全的；标准 http.Handler 是每个请求独立 goroutine，故单次请求内安全。
-
替代方案对比：
- r.Body = ioutil.NopCloser(bytes.NewReader(data))：需先 ioutil.ReadAll(r.Body)，但会丢失原始 Close() 行为；
- 自定义 SeekableBody：过度复杂，违反最小原则；
- 使用中间件统一解析并注入上下文：更工程化，适合大型项目，但本例中 TeeReader 更轻量直接。
✅ 总结
当需要在多个逻辑单元中重复读取同一 HTTP 请求体时，io.TeeReader 配合 bytes.Buffer 是最平衡的解决方案：它零依赖、语义清晰、性能可控，且完全兼容标准库。核心口诀是：“读时即存，存后即替” —— 在首次解码过程中完成缓存，并立即接管 r.Body，让后续操作无缝复用。
