news 2026/6/10 22:49:23

双 Token 机制下的无感刷新(Refresh Token)后端实现

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
双 Token 机制下的无感刷新(Refresh Token)后端实现

AccessToken 过期的三种实践场景

假设AccessToken有效期 30 分钟,RefreshToken有效期 30 天。

场景 1:关闭网页,短时间内(如 5 分钟)又打开

  • 表现直接进入
  • 原理:前端从存储中读取AccessToken发送请求。后端 Filter 发现 Token 签名正确且未过期(只过了 5 分钟),校验通过,用户无需重新登录。

场景 2:关闭网页,过了一天又打开

  • 表现页面闪烁一下(自动刷新),正常进入
  • 原理
  1. 前端发送旧AccessToken,后端返回401 Unauthorized
  2. 前端 Axios 拦截器捕获 401,自动读取RefreshToken调用刷新接口。
  3. 后端验证RefreshToken有效,返回新AccessToken
  4. 前端用新 Token 重新发起业务请求,用户感知不到重新登录的过程。

场景 3:打开网页并持续浏览超过 30 分钟

  • 表现无感续期
  • 原理
  • 在第 31 分钟时,发出的业务请求会因AccessToken过期报 401。
  • 前端拦截器发起“静默刷新”,获取新 Token 并继续完成刚才的操作。
  • 用户在操作过程中几乎无察觉,流程与场景 2 类似。


深度解析:双 Token 机制下的无感刷新(Refresh Token)后端实现

1. 为什么要设计刷新令牌?

在 JWT 架构中,AccessToken通常设置较短的有效期(如 30 分钟),目的是降低泄露后的风险。但如果直接让用户每 30 分钟登录一次,体验会崩溃。
刷新令牌(RefreshToken)的存在,就是为了在不暴露用户账号密码的前提下,实现“令牌续期”,平衡安全与体验。


2. 后端核心实现流程

基于代码逻辑,后端处理refresh_token请求时遵循以下严谨步骤:

第一步:合法性与归属权校验

  • 令牌存在性:首先通过字符串查询数据库/Redis,确认该refreshToken是由系统颁发的。
  • 客户端匹配:校验请求携带的clientId是否与令牌记录中的编号一致。

安全要点:防止攻击者拿着 A 系统的刷新令牌去请求 B 系统的访问令牌(多租户/多应用场景下的关键防御)。

第二步:旧令牌的“彻底清理”(幂等性保证)

  • 双写删除:在生成新令牌前,系统会查出该refreshToken关联的所有旧accessToken
  • 同步清理:同时从MySQLRedis中删除这些旧访问令牌。

目的:确保一个刷新令牌在同一时刻只对应一个有效的访问令牌,防止产生孤儿 Token 占用空间或造成安全隐患。

第三步:过期判定与自毁

  • 逻辑检查:判断refreshTokenexpiresTime是否早于当前时间。
  • 过期处理:一旦发现刷新令牌也过期了,后端会物理删除该刷新令牌,并抛出UNAUTHORIZED异常。

结果:此时前端拦截器会引导用户跳转至登录页,完成“30天”后的重新认证。

第四步:新令牌的“以旧换新”

  • 调用创建方法,生成全新的accessToken,并重新存入缓存,返回给前端。

3. 核心代码

@Override@Transactional(rollbackFor=Exception.class)publicOAuth2AccessTokenDOrefreshAccessToken(StringrefreshToken,StringclientId){// 查询访问令牌OAuth2RefreshTokenDOrefreshTokenDO=oauth2RefreshTokenMapper.selectByRefreshToken(refreshToken);if(refreshTokenDO==null){throwexception0(GlobalErrorCodeConstants.BAD_REQUEST.getCode(),"无效的刷新令牌");}// 校验 Client 匹配OAuth2ClientDOclientDO=oauth2ClientService.validOAuthClientFromCache(clientId);if(ObjectUtil.notEqual(clientId,refreshTokenDO.getClientId())){throwexception0(GlobalErrorCodeConstants.BAD_REQUEST.getCode(),"刷新令牌的客户端编号不正确");}// 移除相关的访问令牌List<OAuth2AccessTokenDO>accessTokenDOs=oauth2AccessTokenMapper.selectListByRefreshToken(refreshToken);if(CollUtil.isNotEmpty(accessTokenDOs)){oauth2AccessTokenMapper.deleteByIds(convertSet(accessTokenDOs,OAuth2AccessTokenDO::getId));oauth2AccessTokenRedisDAO.deleteList(convertSet(accessTokenDOs,OAuth2AccessTokenDO::getAccessToken));}// 已过期的情况下,删除刷新令牌if(DateUtils.isExpired(refreshTokenDO.getExpiresTime())){oauth2RefreshTokenMapper.deleteById(refreshTokenDO.getId());throwexception0(GlobalErrorCodeConstants.UNAUTHORIZED.getCode(),"刷新令牌已过期");}// 创建访问令牌returncreateOAuth2AccessToken(refreshTokenDO,clientDO);}

4. 技术亮点分析(面试/博客加分项)

1. 事务管理 (@Transactional)

在刷新过程中涉及“删旧”与“增新”两个数据库操作,必须保证原子性。如果新令牌生成失败,旧令牌的删除动作应该回滚。

2. 缓存与持久化双校验

  • MySQL负责持久化存储,作为“真值来源”。
  • Redis负责高性能校验,供TokenAuthenticationFilter快速读取。
    这种设计既保证了系统在高并发下的响应速度,又保证了数据不丢失。

3. 安全防范:令牌轮转 (Token Rotation)

虽然此处的refreshToken是复用的,但每次刷新都会注销掉之前所有的accessToken。这在一定程度上防止了令牌被截获后的长期滥用。


5. 总结:前端如何配合?

后端逻辑写得再好,也需要前端的**响应拦截器(Response Interceptor)**配合:

  1. 监控到业务接口返回401(AccessToken 过期)。
  2. 进入“静默重试”队列,调用后端的refresh-token接口。
  3. 获取新 Token 后,自动替换本地存储,并原路重发刚才失败的业务请求。
版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/10 10:57:26

HTTP协议在Java大附件上传中如何优化秒传功能的性能?

项目技术方案&#xff1a;大文件传输系统&#xff08;信创兼容版&#xff09; 编制&#xff1a;湖南长沙某软件公司 技术部 日期&#xff1a;2023年11月20日 一、项目背景与需求分析 公司承接政府项目&#xff0c;需开发一套支持50G文件传输的系统&#xff0c;核心需求如下&a…

作者头像 李华
网站建设 2026/6/10 10:55:52

量产前夜的围剿?EMB专利之争,初创公司与老牌玩家的困局

智能底盘赛道&#xff0c;在迎来“纯线控”大周期的同时&#xff0c;竞争也在加剧。11月底&#xff0c;上市公司伯特利发布公告&#xff0c;起诉苏州坐标系所取得的5项专利属于非法取得&#xff0c;被告通过所获知的公司电子机械制动系统&#xff08;EMB&#xff09; 等产品的相…

作者头像 李华
网站建设 2026/6/10 10:53:59

基于springboot医疗挂号管理系统

系统简介 在如今社会上&#xff0c;关于信息上面的处理&#xff0c;没有任何一个企业或者个人会忽视&#xff0c;如何让信息急速传递&#xff0c;并且归档储存查询&#xff0c;采用之前的纸张记录模式已经不符合当前使用要求了。所以&#xff0c;对医疗挂号信息管理的提升&…

作者头像 李华
网站建设 2026/6/10 10:54:29

8 个降AI率工具,自考人必备的高效降重神器

8 个降AI率工具&#xff0c;自考人必备的高效降重神器 AI降重工具&#xff0c;自考论文的高效护航者 在当前的学术环境中&#xff0c;越来越多的高校和考试机构开始引入AIGC检测系统&#xff0c;这对自考学生的论文写作提出了更高要求。如何在保证内容质量的同时&#xff0c;有…

作者头像 李华
网站建设 2026/6/10 0:29:36

【日记】今天打了一天飞机(435 字)

正文 今天打了一天飞机…… 好爽。 第一次被敌人锁定的时候也让人头皮发麻&#xff0c;我甚至不知道怎么做规避。不过后面被锁着锁着就习惯了…… 后面告诉我能做高 G 滚翻&#xff0c;我试了一下&#xff0c;现实中这么玩儿飞行员早昏迷了吧…… 哪个任务我忘了&#xff0c;让…

作者头像 李华
网站建设 2026/6/10 10:58:04

Python+selenium自动化元素定位防踩坑(建议收藏)

踩坑一&#xff1a;StaleElementReferenceException selenium.common.exceptions.StaleElementReferenceException: Message: stale element reference: element is not attached to the page document 异常原因&#xff1a; 意思是&#xff0c;引用的元素已过期。原因是页面…

作者头像 李华