因为http.Request.Body是单次读取的io.ReadCloser,Echo直接透传该字段,读取后即耗尽;正确做法是在中间件最开始用io.ReadAll()读取并缓存,再通过bytes.NewBuffer重置为可重读的Body。

为什么 c.Request().Body 读一次就空了
因为 Go 的 http.Request.Body 是一个 io.ReadCloser,底层是单次读取的流。Echo 的 c.Request().Body 直接透传这个字段,所以调用 c.Request().Body.Read() 或 ioutil.ReadAll()(或 Go 1.16+ 的 io.ReadAll())后,Body 就被消耗完了。后续再想读——比如你手动解析完 JSON 又想记录原始日志——就会得到空字节。
正确获取原始未解析 Body 的三种方式
核心原则:**必须在 Echo 中间件或路由处理函数最开始、任何其他解析逻辑之前,一次性读完并缓存**。否则后续 c.Bind()、c.JSON() 等操作会静默失败或读到空内容。
Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 用
io.ReadAll()读取后,用bytes.NewBuffer()重置为可重读的io.ReadCloser,再赋给c.Request().Body - 推荐封装成中间件,避免每个 handler 重复写:
func readBodyMiddleware(next echo.HandlerFunc) echo.HandlerFunc {
return func(c echo.Context) error {
body, err := io.ReadAll(c.Request().Body)
if err != nil {
return err
}
c.Set("raw-body", body) // 存到 Context 里供后续使用
c.Request().Body = io.NopCloser(bytes.NewBuffer(body))
return next(c)
}
}
- 如果只是临时用,别改
Request.Body,直接读取并存到c.Set()即可,后续用c.Get("raw-body")取
注意 c.Request().Body 和 c.Request().GetBody 的区别
GetBody 是 Go 标准库为支持重放 Body 设计的可选字段,但默认为 nil。Echo 不会自动设置它,也不能靠它解决原始 Body 问题。很多同学误以为调用 c.Request().GetBody() 就能重新拿到 Body,结果 panic 或返回 nil。
-
c.Request().Body是真实流,只能读一次 -
c.Request().GetBody是可选的工厂函数,需手动设置(如req.GetBody = func() (io.ReadCloser, error) { ... }),不推荐在 Echo 中自行补全 - 依赖
GetBody的第三方库(如某些日志中间件)可能失效,务必实测
Content-Type 为 multipart/form-data 时不能直接读 Body
这类请求的 Body 包含二进制文件和表单字段混合内容,直接 io.ReadAll() 会破坏边界分隔符,导致后续 c.FormValue() 或 c.MultipartForm() 解析失败。
- 如果只需要原始 Body 字节且不解析表单,仍可用
io.ReadAll(),但必须确保后续完全不调用任何 multipart 相关方法 - 如果既要原始 Body 又要正常解析表单/文件,必须用
c.Request().MultipartReader()手动遍历 part,并拼接原始字节——复杂且易错,建议放弃“同时满足”,改用前置代理层捕获 - 绝大多数场景下,遇到 multipart 就不该试图读原始 Body;检查是否真需要,还是只是误配了
Content-Type
c.Set()、重置 Body。别绕弯,也别信 GetBody 能自动兜底。

















