讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

Laper
Laper

剧本策划到成片协作

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

浅磊小哥_6018

浅磊小哥_6018

发布时间:2026-11-21 07:32:38

|

954人浏览过

|

来源于php中文网

原创

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 响应写法:

Echo框架 5.1.0
Echo框架 5.1.0

Echo框架 5.1.0 版本源码包下载,适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。

下载
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 而不设空值在某些浏览器下可能失效。

黑名单检查必须放在 JWT 校验之后、业务逻辑之前

顺序错了就白做了:如果先查黑名单再解析 token,会因 token 格式错误或签名失败而跳过检查;如果放业务逻辑之后,意味着非法 token 已经触发了数据库操作或敏感行为。

典型错误位置:

  • 在 echo.MiddlewareFunc 里直接做黑名单检查,但没确保它在 jwt.WithConfig 之后执行
  • 把黑名单逻辑写在 handler 里,导致部分路由绕过(比如未加中间件的 /health)
  • 用 context.Set 把 token 解析结果传给后续 handler,但黑名单检查用了另一个 context key,导致两次解析 token,性能浪费且 jti 可能不一致

正确做法是封装一个组合中间件,内部按「解析 token → 提取 jti → 查 Redis → 拒绝或放行」严格串行执行,并作为全局认证中间件统一挂载。

复杂点在于 jti 生成、Redis 连接复用、错误日志粒度——这些地方不显眼,但线上一旦漏掉,退出功能就形同虚设。

热门AI工具

更多
笔灵降AI

一款AI论文写作工具,主要用于论文降AI神器,适配知网及维普!一键降至安全线,100%保留原文格式;无口语化问题,文风更学术,降后字数控制最佳!,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

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

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

5654

2025.06.09

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

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

5831

2025.07.04

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

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

399

2026.04.23

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

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

3268

2023.10.19

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

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

5649

2025.10.17

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

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

3909

2025.12.29

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

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

506

2026.01.19

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

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

0

2026.11.20

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

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

20

2026.11.17

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn