JWT中间件单元测试需用gin.CreateTestContext构造真实HTTP上下文,显式设置Request和Authorization头,覆盖header缺失、格式错误、签名失效三类401场景,并确保密钥、算法、claims字段与生成逻辑严格一致。

怎么给 JWT 中间件写可执行的单元测试
直接 mock gin.Context 是可行的,但容易漏掉 header 解析、claims 注入、abort 行为等关键路径。真正能跑通的测试必须构造一个最小但完整的 HTTP 请求上下文,而不是只测函数签名。
用 gin.CreateTestContext 构造真实请求链路
别手动 new 一个空 *gin.Context —— 它依赖 *gin.Engine 和 http.ResponseWriter 才能正确触发 abort、status、header 等行为。官方推荐用 gin.CreateTestContext:
- 它返回
*gin.Context+*httptest.ResponseRecorder组合,能捕获响应状态码、body、header - 必须显式调用
c.Request = httptest.NewRequest(...),否则c.GetHeader("Authorization")永远为空 - 中间件里用
c.Abort()后,后续 handler 不会执行,这点必须验证
示例片段:
func TestJWTMiddleware_ValidToken(t *testing.T) {
r := gin.New()
r.Use(JWTMiddleware()) // 被测中间件
r.GET("/protected", func(c *gin.Context) {
c.String(200, "ok")
})
w := httptest.NewRecorder()
c, _ := gin.CreateTestContext(w)
c.Request = httptest.NewRequest("GET", "/protected", nil)
c.Request.Header.Set("Authorization", "Bearer "+validTokenString)
r.HandleContext(c)
if w.Code != 200 {
t.Fatalf("expected 200, got %d", w.Code)
}
}
测试三种典型错误场景不能只靠 error 字符串
JWT 验证失败有明确语义分类,单元测试要覆盖每种 case 并检查响应细节:
-
Authorizationheader 缺失 → 响应401,body 含"权限不足"(不是泛泛的"unauthorized") - token 格式错误(如少一段、base64 解码失败)→
401,且中间件不能 panic - signature 无效或过期 →
401,但错误信息应和 header 缺失区分开(比如含"token expired"或"invalid signature")
注意:jwt.Parse 对过期 token 默认返回 jwt.ValidationErrorExpired,需在验证逻辑里显式判断并返回对应提示,否则所有错误都混成一个 response。
密钥和算法必须和生产环境完全一致
测试时用硬编码密钥(如 []byte("test-secret"))没问题,但以下两点必须对齐:
- 签名算法必须和
GenerateToken生成时一致:如果生产用jwt.SigningMethodHS256,测试里Parse时也得用相同 method 校验,否则token.Method类型断言失败 - 密钥类型要匹配:HS 系列用
[]byte,RS/ES 系列必须用*rsa.PrivateKey/*ecdsa.PrivateKey,混用会导致Parse直接返回nil, error - 测试生成 token 时,
exp字段必须设为未来时间;若设成过去时间,验证逻辑还没走到 signature 就因过期被拒,掩盖了签名校验路径
最容易被忽略的是:测试中生成的 token 如果没设 iss 或 aud,而中间件验证逻辑里强制检查这两个 claim,测试就会意外失败——这说明验证逻辑和 token 生成逻辑存在隐式耦合,必须暴露出来。











