Beego中间件中不能用c.Ctx.SetCookie,因中间件函数签名是func(ctx context.Context),无c Controller实例;应使用ctx.Output.Cookie()或http.SetCookie(),注意HttpOnly、Secure等安全字段。

中间件里不能直接用 c.Ctx.SetCookie
Beego 的中间件函数签名是 func(ctx *context.Context),它没有 c *Controller 实例,因此无法调用 c.Ctx.SetCookie 这类控制器方法。常见错误是照搬 Controller 写法,在中间件里写 c.Ctx.SetCookie(...),结果编译报错:undefined c。
正确做法是直接操作 ctx.ResponseWriter 或使用 ctx.Output.Cookie:
-
ctx.Output.Cookie(name, value, maxAge, path, domain, secure, httpOnly)是最推荐的方式,它封装了底层http.SetCookie,兼容 Beego v1/v2 - 手动调用
http.SetCookie(ctx.ResponseWriter, &http.Cookie{...})也行,但需自己构造http.Cookie结构体,容易漏掉HttpOnly或Secure字段 - 别用
ctx.Request.Cookie()来“设置”,那是读取用的,会 panic
为什么中间件设 Cookie 常被忽略 httpOnly 和 Secure
很多开发者在中间件里只写 ctx.Output.Cookie("auth_token", token, 3600, "/", "", false, false),导致 Cookie 被前端 JavaScript 读取,存在 XSS 泄露风险。
真实生产环境必须按场景区分:
- 用于身份校验的 token(如
auth_token):务必设httpOnly=true,禁止 JS 访问 - 部署在 HTTPS 环境下:
secure=true必须开启,否则浏览器拒绝发送该 Cookie - 跨子域共享(如
api.example.com和www.example.com):domain=".example.com",注意开头带点 -
maxAge=0表示会话级 Cookie(关闭浏览器即失效),不是“永不过期”
中间件中读取并透传 Cookie 到 Session 的典型场景
比如实现自动登录:中间件检查请求是否带 remember_token,若有效则补全 session,避免用户重复登录。
关键逻辑不是“设 Cookie”,而是“读 → 验证 → 写 Session”:
- 用
ctx.Input.Cookie("remember_token")获取加密后的 token 字符串 - 解密 + 查库验证 token 是否未过期、未吊销(不要明文存 user_id)
- 验证通过后调用
ctx.Input.SetSession("uid", userID),注意这里不是c.SetSession - 同时刷新 remember token 有效期:生成新 token、更新数据库、再用
ctx.Output.Cookie写回新值
漏掉数据库更新或没刷新 cookie,会导致“记住我”一次生效后就失效。
Beego v2 中 context.Context 和旧版 beego.Context 的导入差异
如果你升级到 Beego v2(当前主流版本),中间件必须导入 github.com/beego/beego/v2/server/web/context,而不是老版的 github.com/astaxie/beego/context。
错误写法(v2 下编译失败):import "github.com/astaxie/beego/context"
正确写法:import "github.com/beego/beego/v2/server/web/context"
这个包路径不一致是 v2 兼容性最大坑之一,一旦导错,ctx.Input.Cookie 或 ctx.Output.Cookie 都会找不到方法。


















