Fiber框架中c.BodyParser()不能在中间件调用，因请求体可能已被消费或未就绪；应仅在业务handler中使用，并确保传指针、Content-Type匹配及字段导出；前置校验需用c.Body()手动解析。
中间件里不能直接用 c.BodyParser() 解析 JSON
Fiber 的 BodyParser() 必须在业务 handler 中调用，中间件里调用会失败——因为此时请求体可能已被消费（比如被后续的 form 解析逻辑提前读取），或尚未进入完整解析上下文。常见错误是把鉴权逻辑写成中间件后，还在里面写 err := c.BodyParser(&req)，结果 req 始终是零值，且无报错提示。
真正安全的做法是：只在需要处理 JSON 数据的业务 handler 里解析；中间件只做轻量级检查（如 header、token、路径、查询参数等）。
- 中间件适合做：
c.Get("Authorization")、c.Params("id")、c.Query("v") - 中间件不适合做：
c.BodyParser()、c.FormValue()、c.XML()等需读取并消费原始 body 的操作 - 如果非要在前置阶段校验 JSON 内容（例如强制要求某个字段存在），应改用「预校验 handler」模式：单独注册一个带相同路径的 handler，在业务 handler 之前执行，并显式调用
c.Body()+json.Unmarshal()
想在中间件前校验 JSON 字段？用 c.Body() 手动解码
若你确实需要在进入业务逻辑前验证 JSON 结构（比如所有 POST /api/user 必须含 email 字段），可绕过 BodyParser()，手动读取原始字节并解析。但要注意：这会消费 body，后续 handler 再调 c.BodyParser() 就会失败。
示例代码片段：
func validateJSONField(c *fiber.Ctx) error {
raw := c.Body()
if len(raw) == 0 {
return c.Status(400).JSON(map[string]string{"error": "empty body"})
}
var m map[string]interface{}
if err := json.Unmarshal(raw, &m); err != nil {
return c.Status(400).JSON(map[string]string{"error": "invalid json"})
}
if _, ok := m["email"]; !ok {
return c.Status(400).JSON(map[string]string{"error": "email required"})
}
// 注意：这里不 return，而是继续走 next
return c.Next()
}
- 必须用
c.Body()，不是c.Request().Body()—— 后者返回的是*fasthttp.ByteBuffer，需额外调.Bytes() - 解析失败时记得
return错误响应，否则流程继续，业务 handler 可能 panic - 该中间件必须放在
app.Use()链中，且位置早于任何依赖BodyParser()的 handler
为什么 c.BodyParser() 在 handler 里也常出错
即使你在业务 handler 里调用 c.BodyParser()，仍可能拿到空结构体或静默失败。根本原因是没传指针，或者 Content-Type 不匹配。
- 必须传地址：
err := c.BodyParser(&user)，写成c.BodyParser(user)或c.BodyParser(&user)（多一个 &）都会失败 - 客户端必须发
Content-Type: application/json，否则 Fiber 不认为这是 JSON 请求，BodyParser()会跳过解析 - 结构体字段要导出（首字母大写），且带
json:tag，否则反序列化后字段为空 - 错误不会自动转 HTTP 400，需手动判断
err != nil并返回响应
更稳妥的方案：用专用 JSON 校验中间件 + 显式错误处理
如果你的 API 大部分接口都要求 JSON 输入，建议封装一个可复用的校验中间件，统一处理解析、字段校验和错误响应。它不替代业务 handler，而是前置拦截非法输入。
关键点：
- 只对
POST/PUT/PATCH且Content-Type包含application/json的请求生效 - 用
json.RawMessage做延迟解析，避免重复解码 - 校验失败时立即
return，不调c.Next() - 把解析好的 raw JSON 存入 context：
c.Locals("json_raw", raw)，供后续 handler 复用
这种模式下，业务 handler 只需从 c.Locals 拿数据或再次解析，不用操心基础校验逻辑。真正的坑不在语法，而在 body 被谁先读走了、什么时候读、读了几遍。
