JWT退出登录需通过Redis黑名单作废,logout时存jti并设TTL略长于token有效期,校验中间件须在JWT解析后、业务前检查黑名单,同时清除HttpOnly Cookie。

退出登录时 JWT 无法真正“删除”,只能作废
JWT 是无状态的,服务端不存 token,所以 logout 接口不能靠“删 token”实现作废。必须额外维护一个黑名单(或 Redis 缓存)记录已登出的 token,每次请求校验时先查这个列表。否则用户即使退出,拿到的旧 token 在过期前仍可继续访问。
用 Redis 存储已登出的 JWT 黑名单
推荐在用户调用 logout 时,把当前 token 的 jti(JWT 唯一标识)和过期时间一起写入 Redis,设置 TTL 略长于 token 过期时间(比如 token 有效期 1h,Redis key 设为 1h10m)。这样既保证作废时效,又避免长期占用内存。
实操建议:
-
jti字段需在签发 token 时显式生成(如用uuid.NewString()),不能依赖客户端传入 - Redis key 格式建议统一为
blacklist:jti:{jti},方便清理和监控 - 校验中间件中,先解析 token 得到
jti,再用redis.Exists(ctx, "blacklist:jti:"+jti)判断是否已登出 - 若使用
github.com/gofiber/jwt/v3,需在自定义jwt.ExtractToken后插入黑名单检查逻辑,不能只依赖默认校验
Logout 接口要同时清除客户端 Cookie 和服务端黑名单
前端通常把 JWT 存在 HttpOnly Cookie 中,后端 logout 接口除了写入 Redis,还必须返回清除 Cookie 的响应头。否则浏览器下次请求仍会自动带上旧 token。
示例 Echo 响应写法:
func logout(c echo.Context) error {
cookie, _ := c.Cookie("token")
jti := extractJTIFromToken(cookie.Value) // 自行实现,从 token payload 解析 jti
redisClient.Set(c.Request().Context(), "blacklist:jti:"+jti, "1", 61*time.Minute)
// 清除客户端 Cookie
c.SetCookie(&http.Cookie{
Name: "token",
Value: "",
Path: "/",
MaxAge: -1,
HttpOnly: true,
Secure: true, // 生产环境务必开启
SameSite: http.SameSiteStrictMode,
})
return c.NoContent(http.StatusOK)
}
注意:MaxAge: -1 和 Value: "" 缺一不可;仅设空值不删 Cookie,仅设 MaxAge: -1 而不设空值在某些浏览器下可能失效。
Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
黑名单检查必须放在 JWT 校验之后、业务逻辑之前
顺序错了就白做了:如果先查黑名单再解析 token,会因 token 格式错误或签名失败而跳过检查;如果放业务逻辑之后,意味着非法 token 已经触发了数据库操作或敏感行为。
典型错误位置:
- 在
echo.MiddlewareFunc里直接做黑名单检查,但没确保它在jwt.WithConfig之后执行 - 把黑名单逻辑写在 handler 里,导致部分路由绕过(比如未加中间件的
/health) - 用
context.Set把 token 解析结果传给后续 handler,但黑名单检查用了另一个 context key,导致两次解析 token,性能浪费且 jti 可能不一致
正确做法是封装一个组合中间件,内部按「解析 token → 提取 jti → 查 Redis → 拒绝或放行」严格串行执行,并作为全局认证中间件统一挂载。
复杂点在于 jti 生成、Redis 连接复用、错误日志粒度——这些地方不显眼,但线上一旦漏掉,退出功能就形同虚设。










