直接往*gin.Context里塞session或cookie不起作用,因Gin默认不解析Cookie或管理session;需显式集成gin-contrib/sessions等中间件,或手动用c.Set()注入登录态(如c.Set("user_id", 1001))进行测试。

直接往 *gin.Context 里塞 session 或 cookie 不起作用
很多人第一反应是“那我 mock 一个带 Cookie 的请求不就行了”,但 Gin 的 gin.Context 默认不解析或管理 session,也不自动读取 Cookie 字段做登录态校验——除非你显式集成第三方 session 中间件(如 gin-contrib/sessions)并配置了 store。纯用 httptest.NewRequest 设置 Cookie 头,若 handler 里没调用 c.GetHeader("Cookie") 或类似逻辑,它就只是个字符串,不会自动变成“已登录”。
最常用且可靠的做法:手动注入上下文值(c.Set())
绝大多数 Gin 项目里的登录中间件(比如 JWT 校验、token 解析、session 验证)最终都会把用户信息存进 c 的上下文,例如:c.Set("user_id", 123) 或 c.Set("user", &User{...})。单元测试时,你完全可以跳过中间件,直接模拟这个结果:
- 在测试中构造一个
*gin.Context实例(通过gin.CreateTestContext) - 调用
c.Set("user_id", 1001)和c.Set("role", "admin")等关键字段 - 再把该
c传给待测 handler 函数(注意:handler 是func(*gin.Context)类型,可直接调)
示例片段:
func TestProtectedHandler(t *testing.T) {
r := gin.New()
w, c := gin.CreateTestContext(httptest.NewRecorder())
c.Request = httptest.NewRequest("GET", "/api/profile", nil)
// 手动注入登录态
c.Set("user_id", int64(1001))
c.Set("user_role", "admin")
// 直接调 handler,不走路由匹配
ProfileHandler(c)
assert.Equal(t, http.StatusOK, w.Code)
}
如果用了 gin-contrib/sessions,得 mock session store
一旦项目真实接入了 session(比如基于 Redis 或 cookie 加密),测试就不能只靠 c.Set() 了,因为 handler 里大概率会写类似 session.Get("user_id") 这样的调用。这时你需要:
- 用
mockstore(官方提供)或自己实现一个轻量session.Store接口 - 在测试 setup 阶段注册该 store:
sessions.DefaultManager.Store = mockStore - 确保请求携带合法的
Cookie: session_id=xxx,且 mockStore 能按该 ID 返回预设的 session 数据
注意:这不是 Gin 自带能力,而是 gin-contrib/sessions 的行为;没引入它就不用考虑这层。
JWT 场景下,伪造 Authorization Header 最简单
如果登录态靠 JWT token,handler 通常从 c.Request.Header.Get("Authorization") 提取 Bearer token 并解析。测试时无需真签 token,只要让解析逻辑能过即可:
- 用
jwt.Parse的 mock 版本,或直接 patch 解析函数返回固定*jwt.Token - 更轻量做法:在测试请求里带上伪造 header:
req.Header.Set("Authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...") - 关键点:确保你的 JWT 解析逻辑对 token 内容不做强校验(比如跳过 signature 验证),或使用测试专用密钥 + 预生成合法 token
容易踩的坑:time.Now() 导致的 exp 过期、aud/iss 校验失败——测试时建议用固定时间戳生成 token,或临时禁用这些检查。
真正难的不是“怎么模拟”,而是搞清你的登录态实际由哪一层承载:是中间件塞进 c 的值?是 session.Store 查出来的?还是 JWT 解析后的 claims?选错模拟层级,测试就永远跑不通。


















