中间件里不能直接用 GetString 或 ParseForm,因中间件接收 context.Context 而非 Controller,无这些封装方法;须直接操作 c.Ctx.Request:ParseForm 后读 PostForm(仅 body)、开启 copyrequestbody 后解析 JSON、对 multipart 需 ParseMultipartForm。

中间件里不能直接用 GetString 或 ParseForm
Beego 中间件函数接收的是 *context.Context,不是 *Controller,所以没有 GetString、ParseForm 这些方法。这些是 Controller 实例才有的封装,中间件里调用会编译报错或 panic。
常见错误现象:
在中间件里写 c.GetString("token") → 编译失败,提示 undefined;
试图调用 c.ParseForm(&v) → 方法不存在,IDE 直接标红。
正确做法是直接操作底层 http.Request:
-
c.Ctx.Request.ParseForm()后读c.Ctx.Request.PostForm(仅适用于application/x-www-form-urlencoded) - 若 Content-Type 是
application/json,需先确保copyrequestbody = true,再用json.Unmarshal(c.Ctx.Input.RequestBody, &v) - 对
multipart/form-data,必须调c.Ctx.Request.ParseMultipartForm(),然后用c.Ctx.Request.MultipartForm
POST 表单数据:用 ParseForm + PostForm 区分来源
c.Ctx.Request.ParseForm() 会把 query string 和 body 都解析进 Form,但中间件常需要只取 POST body(比如鉴权 token 不该从 URL 拿)。这时得用 PostForm —— 它只含 body 解析结果,不含 query。
实操要点:
- 必须在读取前调
c.Ctx.Request.ParseForm(),否则PostForm是空的 -
c.Ctx.Request.PostForm.Get("api_key")返回string,不带 error;若 key 不存在,返回空字符串 - 如果字段可能为空或类型敏感(如
int),别依赖隐式转换,应手动strconv.Atoi并检查 error - GET 请求调
ParseForm后PostForm仍是空 map,不会误拿 query 参数
JSON Body:必须开 copyrequestbody 才能读两次
Beego 默认不缓存原始请求体,c.Ctx.Input.RequestBody 第一次读完就变空切片。中间件若需多次解析(比如先验签、再转发给 controller),必须提前开启配置。
配置方式(写在 conf/app.conf 的对应环境段下,如 [dev]):
copyrequestbody = true
代码中使用:
if c.Ctx.Request.Method == "POST" && c.Ctx.Request.Header.Get("Content-Type") == "application/json" {
var req struct{ Token string `json:"token"` }
if err := json.Unmarshal(c.Ctx.Input.RequestBody, &req); err != nil {
c.Abort("400")
return
}
// 后续 controller 仍可正常 Unmarshal,因为 body 已缓存
}
注意:copyrequestbody = true 有内存开销,生产环境建议只对必要路由启用(如 /api/ 前缀),不要全局打开。
中间件里取参容易漏掉的边界情况
很多中间件卡在“看似取到了,实际逻辑错乱”,问题往往出在协议细节上:
-
Content-Type缺失或拼写错误(如application/json多个空格)→ParseForm或Unmarshal静默失败 - 前端发 JSON 但没设
Content-Type: application/json→ Beego 当作普通表单处理,RequestBody里是 raw 字符串,Unmarshal报invalid character - 同时存在 query 和 body 同名参数(如
?id=1&id=2和{"id":3})→ParseForm的Form只保留最后一个,PostForm只含 body 的3,但开发者常误以为能 merge - 中间件注册位置不对:用
beego.InsertFilter("/api/", beego.BeeApp.FilterType, f)注册,但忘了FilterType对应的是BeforRouter阶段,此时RequestBody还未被 Beego 内部读取,可安全解析;若错用FinishRouter,body 可能已被消费
最稳妥的做法:中间件只做轻量校验(如 token、签名、限流),把完整参数解析留给 Controller 层,避免在中间件里重复实现业务级解包逻辑。


















