Echo v4 中不存在官方 BodyDump 中间件，需自行实现：读取并缓存 Request.Body 后用 io.NopCloser 重置，避免后续解析失败；大 Body 场景应改用 Logger 或按需调试，敏感接口须跳过记录。
BodyDump中间件在Echo v4中根本不存在
Echo 官方没有提供 BodyDump 中间件，这是常见误解。你搜到的示例大概率来自早期第三方封装、过时博客，或把其他框架（比如 Gin 的 gin.BodyDump）记混了。直接调用 echo.BodyDump() 会报 undefined: echo.BodyDump。
想记录完整请求体，得自己实现读取逻辑
Echo 的 Context.Request().Body 是单次读取流，一旦被中间件或 handler 调用过 ctx.Request().Body（比如用 ctx.Bind() 或 io.ReadAll()），后续再读就是空的——这会导致后续 handler 解析失败。
正确做法是：用 io.TeeReader 或临时缓存 Body 内容，并重置 Request.Body：
func BodyDumpMiddleware() echo.MiddlewareFunc {
return func(next echo.HandlerFunc) echo.HandlerFunc {
return func(c echo.Context) error {
// 读取原始 body
body, err := io.ReadAll(c.Request().Body)
if err != nil {
return err
}
// 记录日志（注意：生产环境慎记敏感字段）
log.Printf("REQ [%s] %s | Body: %s", c.Request().Method, c.Request().URL.Path, string(body))
// 重置 Body，供后续 handler 正常读取
c.Request().Body = io.NopCloser(bytes.NewBuffer(body))
return next(c)
}
}
}
- 必须用
io.NopCloser包装bytes.Buffer，否则类型不匹配 - 不能直接用
strings.NewReader，因为Request.Body要求实现io.ReadCloser - 若请求体很大（如文件上传），该方式会吃内存，不适合高并发大 Body 场景
更安全的替代方案：只记录关键字段或用 AccessLog + 自定义格式
真正需要调试时才全量 dump Body；日常日志推荐用 Echo 内置 middleware.Logger 配合自定义格式，避开 Body 读取问题：
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
e.Use(middleware.LoggerWithConfig(middleware.LoggerConfig{
Format: "${time_rfc3339} | ${method} ${uri} | ${status} | ${latency_human} | ${remote_ip}\n",
}))
- 它不碰
Body，无副作用，性能好 - 若真要关联请求体，可结合 trace ID：在中间件里生成
X-Request-ID，记录 Body 时带上该 ID，再和 access log 关联查 - 敏感接口（如登录、支付）应主动跳过 Body 记录，避免日志泄露密码/令牌
第三方库 echo-middleware/bodydump 不推荐直接用
确实存在社区封装的 github.com/echo-middleware/bodydump，但它内部仍是基于上述 io.ReadAll + NopCloser 实现，且未处理 multipart、gzip 编码等边界情况。
使用前务必确认：
- 你的 Echo 版本是否兼容（v4.10+ 和 v5 API 差异大）
- 是否已禁用
echo.HTTPErrorHandler的 panic 捕获——否则 Body 读取异常可能被吞掉 - 是否配置了
Content-Type白名单（如只记录application/json，跳过multipart/form-data）
真正难的不是“怎么加中间件”，而是“什么时候不该读 Body”——这个判断比代码本身更重要。
