Buffalo 默认不支持请求体多次读取，因其直接透传 Go 标准库的单次可读 http.Request.Body；需在最上游中间件用 io.ReadAll 缓存并替换为 io.NopCloser(bytes.NewReader()) 才能实现可重读。
Buffalo 默认不支持请求体多次读取，强行尝试会返回空内容或 panic。它的 buffalo.Context 底层封装了 *http.Request，而 Go 标准库的 Request.Body 是单次可读的 io.ReadCloser——读完就 EOF，后续再 Read() 就是 0 字节。你若在中间件里解析一次 JSON，又在 handler 里调 c.Request().Body，大概率拿到空数据。
为什么 Buffalo 的 c.Request().Body 不能重复读
Buffalo 没有像 Gin 那样默认用 httputil.DumpRequest 或自定义 io.NopCloser 包装 Body；它直接透传原始 Request.Body。一旦被 json.NewDecoder(c.Request().Body).Decode() 消费，底层 bytes.Buffer 或 network conn 的 reader offset 就已到底部。
- 常见错误现象：
c.Param("id")正常，但json.NewDecoder(c.Request().Body).Decode(&v)第二次调用失败，v保持零值 - 真实场景：你在中间件做签名验签（需读 Body），然后 handler 还要解 JSON —— 不做处理就会丢数据
- 根本原因：Go 的
http.Request.Body设计就是“一次性消费”，Buffalo 没加 wrapper 层去缓存
手动实现 Body 可重读的两种可靠方式
必须在请求进入第一个中间件时就把 Body 缓存下来，并替换为可重复读的新 Body。推荐用 bytes.NewReader + io.NopCloser 组合：
- 先读全部：
bodyBytes, _ := io.ReadAll(c.Request().Body) - 关闭原 Body：
c.Request().Body.Close()（避免 fd 泄漏） - 重置 Body：
c.Request().Body = io.NopCloser(bytes.NewReader(bodyBytes)) - 注意：此操作只应在最上游中间件做一次；重复执行会导致
bodyBytes越读越大（因为每次 ReadAll 都从头开始）
示例中间件：
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
func ReadBodyMiddleware(next buffalo.Handler) buffalo.Handler {
return func(c buffalo.Context) error {
bodyBytes, err := io.ReadAll(c.Request().Body)
if err != nil {
return errors.WithStack(err)
}
c.Request().Body.Close()
c.Request().Body = io.NopCloser(bytes.NewReader(bodyBytes))
// 可选：把 bodyBytes 存进 context，供后续 handler 直接用
c.Set("raw_body", bodyBytes)
return next(c)
}
}
校验逻辑该放哪？别在 handler 里重复解析
Body 多次读取只是手段，真正需求是「统一校验 + 业务解耦」。不要让每个 handler 都自己 Decode 一遍——容易漏校验、字段不一致、性能浪费。
- 把校验逻辑下沉到中间件：解析 JSON 后校验字段必填、长度、格式，失败直接
return c.Error(400, err) - 校验通过后，把结构体实例存进
c.Set("parsed_payload", &v)，handler 里c.Get("parsed_payload")拿即可 - 避免用
c.Request().FormValue或c.Param混合处理：Body 是 JSON，不是表单，别误用ParseForm() - 性能影响：ReadAll() 会把整个 Body 加载进内存，大文件上传场景慎用；此时应改用流式校验（如检查 Content-Length 头、用
json.Decoder.Token()边读边验）
Buffalo 特有的坑：模板中间件可能偷偷读 Body
如果你没禁用模板引擎（app.Templates = nil），Buffalo 的 render.Middleware 在某些路径下会尝试调 c.Request().MultipartReader() 或 c.Request().FormValue()，间接触发 Body 消费——即使你没显式调用 Render。
- 最容易踩的点：开启 session 中间件（
session.Middleware）后，它内部会调ParseMultipartForm，导致 Body 被提前读空 - 解决方案：BFF 或纯 API 场景下，务必显式禁用：
app.Use(session.Middleware())→ 改成// app.Use(session.Middleware())，并确认app.Templates = nil - 验证是否生效：在中间件开头打日志
fmt.Printf("body len: %d\n", c.Request().ContentLength)，如果后续变 0，说明有中间件偷读了
真正稳定的 Body 多次读取，依赖的是「主动缓存 + 严格控制中间件链」，而不是指望 Buffalo 自动帮你兜底。它不是为纯 API 场景设计的框架，这点必须接受。
