Echo框架怎么实现用户退出登录并作废JWT

浅磊小哥_6018

浅磊小哥_6018

2026-11-21

954人浏览

原创

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

echo框架怎么实现用户退出登录并作废jwt

退出登录时 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
Echo框架 5.1.0

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 连接复用、错误日志粒度——这些地方不显眼,但线上一旦漏掉,退出功能就形同虚设。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

echo框架jwt echo框架

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

2025.06.09

5654

18

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

2025.07.04

5831

25

C++ 智能指针与现代内存管理
C++ 智能指针与现代内存管理

深入讲解 C++ 现代内存管理的核心工具——智能指针,涵盖 unique_ptr 独占所有权语义、shared_ptr 引用计数机制与循环引用问题、weak_ptr 弱引用的应用场景、make_unique/make_shared 工厂函数的性能优势、自定义删除器的编写、RAII 资源管理思想的实践,以及从裸指针迁移到智能指针的重构策略,帮助开发者编写安全无泄漏的现代 C++ 代码。

2026.04.23

399

31

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3268

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

5649

12

php8.4实现接口限流的教程
php8.4实现接口限流的教程

PHP8.4本身不内置限流功能,需借助Redis(令牌桶)或Swoole(漏桶)实现;文件锁因I/O瓶颈、无跨机共享、秒级精度等缺陷不适用高并发场景。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2025.12.29

3909

9

java接口相关教程
java接口相关教程

本专题整合了java接口相关内容,阅读专题下面的文章了解更多详细内容。

2026.01.19

506

15

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

2026.11.20

0

8

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Echo框架IP地址文档
Echo框架IP地址文档

共0课时 | 0人学习

Echo框架中文安装文档
Echo框架中文安装文档

共0课时 | 0人学习

Echo框架快速入门指南
Echo框架快速入门指南

共0课时 | 0人学习