Beego中间件中c.Ctx.Input.RequestBody常为空,因默认不缓存且惰性加载,需提前设beego.BConfig.CopyRequestBody=true或手动读取并重置Body。

中间件里直接读 c.Ctx.Input.RequestBody 为什么经常是空的
因为 Beego 默认不缓存原始请求体,c.Ctx.Input.RequestBody 是惰性加载的——它只在首次调用 c.ParseForm()、c.GetString() 或显式启用 CopyRequestBody 后才被填充。中间件执行时若没触发过这些操作,RequestBody 就是 nil 或空 slice。
常见误操作:在中间件里直接 json.Unmarshal(c.Ctx.Input.RequestBody, &v) → 解析失败或 panic,但无明确报错提示。
- 必须在
main.go初始化阶段设置beego.BConfig.CopyRequestBody = true - 该配置需在
beego.Run()之前生效,否则无效 - 即使设置了,若请求体过大(如上传文件),仍可能因内存限制被截断,建议配合
MaxMemory控制
如何在中间件中安全解析 JSON 请求体
不是所有中间件都需要完整解析 JSON,但若要做鉴权、日志、限流等前置处理,就得可靠读取 body 内容。关键点在于:不能破坏后续 controller 对 body 的使用。
- 用
io.ReadAll(c.Ctx.Request.Body)手动读取,然后重置Request.Body为bytes.NewReader(buf),否则 controller 的ParseForm()或后续json.Unmarshal会读到 EOF - 不要重复调用
c.Ctx.Input.RequestBody多次——它只在第一次访问时从Request.Body拷贝一次,之后返回缓存值 - 如果只是校验签名或提取字段(如
token),建议用url.ParseQuery(c.Ctx.Request.URL.RawQuery)或解析 header,避免触碰 body
beego.InsertFilter 注册位置影响 body 可读性
过滤器注册时机决定你能拿到什么数据。比如注册在 beego.BeforeStatic 的中间件,根本收不到 API 请求;而注册在 beego.BeforeRouter 的,能读 body,但此时路由还没匹配,无法按路径做精细控制。
- 要读 JSON body 并做路径/方法判断,推荐注册在
beego.BeforeExec:路由已匹配、controller 已确定、body 尚未被消费 - 避免在
beego.BeeApp.FilterType(即全局 FilterType)注册——它在BeforeRouter阶段执行,body 还没被拷贝,RequestBody为空风险极高 - 若必须在
BeforeRouter阶段读 body,请确保CopyRequestBody = true且手动调用一次c.Ctx.Input.RequestBody触发初始化(但不推荐,语义不清)
POST 表单和 JSON 混合场景下的读取陷阱
有些客户端会把 JSON 放在表单字段里(如 data={"a":1}),或同时发送 application/x-www-form-urlencoded 和 JSON body ——这种非标准用法会让读取逻辑变得脆弱。
- 先检查
c.Ctx.Request.Header.Get("Content-Type"),区分application/json和表单类型 - 对表单类型,优先用
c.ParseForm()+c.GetString("data")提取字段再解析 JSON,而非硬读RequestBody - 若 Content-Type 不匹配但 body 看似 JSON,可尝试用
bytes.HasPrefix(buf, []byte("{"))做轻量探测,但别依赖这个做核心逻辑
真正安全的 body 读取,永远建立在明确的协议约定之上;中间件不该替上游修复混乱的请求格式。











