accesstoken和refreshtoken的理解

前后端利用accessToken与refreshToken无感刷新 项目初衷 以jwt(由header,payload和signature组成)为例,用户登录成功,后端返回accessToken。前端保存,请求接口携带,一切都是水到渠成的 可是在acessToken失效时,你正好请求一次接口,接口就挂了,可能你就跳到登录页了,用户体验也不好。我们希望虽然过期了,但是页面偷偷地刷新,不影响当前接口运行。如果你的方案是把accessToken的有效期设置地久一点,比如100年。你真的是个机智Boy,那设置jwt的意义何在。 方案 accessToken和refreshToken 阅读详情

一个企业级完整的 React AuthProvider + 自动刷新 AccessToken + 过期退出 示例。
核心思路:

  1. AccessToken 有效期短(例如 30 分钟)

  2. RefreshToken 有效期长(例如 7 天)

  3. 前端 UI 状态与后端权限保持一致

  4. AccessToken 过期 → 自动刷新

  5. RefreshToken 过期 → 自动退出登录

下面是完整示例:

import React, { createContext, useState, useEffect, useContext } from 'react';
import axios from 'axios';
import { login as loginApi, logout as logoutApi, refreshToken as refreshTokenApi } from '../api/auth';

export const AuthContext = createContext(null);

export const AuthProvider = ({ children }) => {
  const [user, setUser] = useState(null);
  const [token, setToken] = useState(null);
  const [loading, setLoading] = useState(true);
  const [isAuthenticated, setIsAuthenticated] = useState(false);

  // 初始化:检查 token + refresh token
  useEffect(() => {
    const initAuth = async () => {
      const storedToken = localStorage.getItem('token');
      const storedRefreshToken = localStorage.getItem('refreshToken');
      const storedUser = localStorage.getItem('user');

      if (!storedToken || !storedRefreshToken || !storedUser) {
        setLoading(false);
        return;
      }

      setToken(storedToken);
      setUser(JSON.parse(storedUser));
      setIsAuthenticated(true);

      // 这里可以尝试刷新 token,如果已过期
      try {
        await tryRefreshToken();
      } catch (error) {
        logout();
      }

      setLoading(false);
    };

    initAuth();
  }, []);

  // 登录
  const login = async (credentials) => {
    const response = await loginApi(credentials);
    const { code, message, data } = response;

    if (code !== 200) {
      setIsAuthenticated(false);
      setUser(null);
      setToken(null);
      throw new Error(message || '登录失败');
    }

    const { token: accessToken, refreshToken, userType, userName } = data;
    const userData = { userType, userName };

    setToken(accessToken);
    setUser(userData);
    setIsAuthenticated(true);

    localStorage.setItem('token', accessToken);
    localStorage.setItem('refreshToken', refreshToken);
    localStorage.setItem('user', JSON.stringify(userData));
  };

  // 登出
  const logout = async () => {
    try {
      await logoutApi();
    } catch (error) {
      console.error('登出API失败', error);
    } finally {
      setToken(null);
      setUser(null);
      setIsAuthenticated(false);

      localStorage.removeItem('token');
      localStorage.removeItem('refreshToken');
      localStorage.removeItem('user');
    }
  };

  // 尝试刷新 token
  const tryRefreshToken = async () => {
    const storedRefreshToken = localStorage.getItem('refreshToken');
    if (!storedRefreshToken) throw new Error('没有 refresh token');

    try {
      const res = await refreshTokenApi({ refreshToken: storedRefreshToken });
      const { accessToken, refreshToken } = res.data;

      setToken(accessToken);
      localStorage.setItem('token', accessToken);
      localStorage.setItem('refreshToken', refreshToken);
    } catch (error) {
      throw new Error('Refresh token 已过期');
    }
  };

  // Axios 拦截器,自动刷新 token 或退出登录
  useEffect(() => {
    const interceptor = axios.interceptors.response.use(
      (res) => res,
      async (error) => {
        const originalRequest = error.config;

        if (error.response?.status === 401 && !originalRequest._retry) {
          originalRequest._retry = true;

          try {
            await tryRefreshToken();
            originalRequest.headers['Authorization'] = 'Bearer ' + localStorage.getItem('token');
            return axios(originalRequest);
          } catch (e) {
            logout();
            return Promise.reject(e);
          }
        }

        return Promise.reject(error);
      }
    );

    return () => {
      axios.interceptors.response.eject(interceptor);
    };
  }, []);

  const value = {
    user,
    token,
    loading,
    isAuthenticated,
    login,
    logout,
  };

  return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;
};

export const useAuthStore = () => {
  const context = useContext(AuthContext);
  if (!context) throw new Error('useAuthStore 必须在 AuthProvider 内使用');
  return context;
};

✅ 效果说明

  1. 页面刷新 → 尝试恢复 token,并刷新一次 AccessToken,如果 RefreshToken 有效

  2. AccessToken 过期 → 自动刷新 token,无需登出

  3. RefreshToken 过期 → 前端自动登出,并清理 localStorage

  4. 所有 axios 请求 401 → 自动刷新或登出


前端 RefreshToken 自动续签 + AccessToken 过期退出逻辑 的完整流程


JWT + RefreshToken 生命周期图

用户登录
   │
   ▼
后端返回:
{
  accessToken (30分钟),
  refreshToken (7天)
}
   │
   ├─ 前端保存:
   │   localStorage.token = accessToken
   │   localStorage.refreshToken = refreshToken
   │   localStorage.user = userData
   ▼
前端正常访问接口 (带 AccessToken)
   │
   ▼
后端验证 AccessToken
   ├─ 有效 → 返回数据
   └─ 过期 → 返回 401
               │
               ▼
      前端 Axios 拦截器捕获 401
               │
               ▼
        尝试刷新 AccessToken (用 RefreshToken)
               │
        ┌──────┴────────┐
        │               │
 RefreshToken 有效      RefreshToken 过期
        │               │
        ▼               ▼
 后端返回新 AccessToken   前端登出
        │
        ▼
前端保存新 AccessToken
        │
        ▼
重试原请求 → 用户无感知

🔹 说明

  1. AccessToken(短期)

    • 用于每次接口访问

    • 过期快(30分钟)

    • 过期 → 自动刷新

  2. RefreshToken(长期)

    • 用于刷新 AccessToken

    • 过期慢(7天)

    • 过期 → 强制登出

  3. 前端状态逻辑

    • isAuthenticated = token存在 && token未过期

    • 页面刷新 → 尝试用 RefreshToken 刷新 AccessToken

    • RefreshToken 无效 → 自动登出

  4. 企业级特点

    • 用户体验:不会因为 AccessToken 过期而突然登出

    • 安全性:AccessToken 短期有效,盗用风险低

    • 全局统一:Axios 拦截器 + 后端校验 + 前端状态一致

情况前端 UI后端验证
AccessToken 有效显示登录接口正常返回数据
AccessToken 过期,RefreshToken 有效自动刷新 token → 显示登录返回新 AccessToken
AccessToken 过期,RefreshToken 过期前端 logout → 显示未登录401 Unauthorized

核心:AccessToken 到期不等于登出,只有 RefreshToken 到期才真正登出。


[用户访问页面 / 刷新页面]
          │
          ▼
[AuthProvider useEffect 初始化]
          │
          ▼
  localStorage 检查 token / refreshToken / user
          │
   ┌──────┴──────┐
   │             │
 token / refreshToken 不存在 → logout → 显示未登录
   │
   ▼
 token / refreshToken 存在 → 尝试刷新 token
          │
   ┌──────┴──────┐
   │             │
刷新成功 → 更新 AccessToken → 保持登录状态
刷新失败 → logout → 显示未登录
          │
          ▼
[用户访问接口]
          │
          ▼
后端验证 AccessToken
   ┌─────────┴─────────┐
   │                   │
 AccessToken 有效 → 返回数据
 AccessToken 过期 → 返回 401
          │
          ▼
[Axios 拦截器捕获 401]
          │
   ┌──────┴──────┐
   │             │
尝试刷新 token      RefreshToken 已过期 → logout
   │
刷新成功 → 更新 AccessToken → 重试请求 → 用户无感知
刷新失败 → logout → 显示未登录

🔹 说明

  1. 前端缓存(localStorage)

    • 只是“假设登录状态”,不保证有效

    • 主要作用:刷新页面时可以尝试恢复登录

  2. AccessToken(短期)

    • 用于每次接口访问

    • 过期 → 后端返回 401 → 前端自动刷新或登出

  3. RefreshToken(长期)

    • 用于刷新 AccessToken

    • 过期 → 必须登出,UI 才显示未登录

  4. 企业级特点

    • 用户体验好:AccessToken 过期不影响 UI

    • 安全性高:AccessToken 短期有效,盗用风险低

    • 前端状态与后端权限同步,保证不会假象登录

前端                               后端
───────────────                 ───────────────

用户登录  ───────────────▶   验证账号密码
                               │
                               ▼
                       返回 AccessToken(30m)
                       返回 RefreshToken(7d)
                               │
                               └─────────▶ 前端存 localStorage
                                         token + refreshToken + user

────────────────────────────────────────────────────────────

用户访问接口 ─────────────▶ 后端验证 AccessToken
                           ├─ AccessToken 有效 → 返回数据
                           └─ AccessToken 过期 → 返回 401

────────────────────────────────────────────────────────────

Axios 拦截器捕获 401 ─────────▶ 尝试刷新 AccessToken
                                   │
                      ┌────────────┴────────────┐
                      │                         │
               RefreshToken 有效             RefreshToken 过期
                      │                         │
         后端返回新 AccessToken               后端返回 401
                      │                         │
前端更新 token → 重试原请求             前端 logout → 清理 localStorage
                      │                         │
                      ▼                         ▼
          用户无感知,继续操作            用户真正登出,UI显示未登录

5分钟搞定前后端无感刷新:accessToken与refreshToken实战指南(含axios拦截器配置) 本文详细介绍了如何通过accessToken和refreshToken实现前后端无感刷新机制,提升用户认证体验。包含axios拦截器配置和Node.js后端实现,解决token过期时的自动刷新问题,确保会话连续性。特别适合中小型项目快速集成,5分钟内即可完成部署。 阅读详情

相关推荐

Google OAuth2实战:如何高效管理RefreshToken与AccessToken的生命周期

本文深入探讨了Google OAuth2应用中RefreshToken与AccessToken生命周期的核心管理策略。针对应用频繁“掉线”的问题,文章详细解析了如何通过`access_type=offline`和`prompt=consent`参数确保获取RefreshToken,并重点介绍了RefreshToken的安全持久化存储方案与自动刷新AccessToken的可靠机制,从而构建稳定、安全的长期访问能力。

weixin_29202213的博客 535

access_token VS refresh_token

众所周知, 在 OAuth 2.0 授权协议中, 有两个令牌 token , 分别是 access_token 和 refresh_token, 为什么已经有了 access_token, 还需要 refresh_token 呢? 我们先看下面两者的介绍 access_token 访问令牌, 它是一个用来访问受保护资源的凭证 refresh_token 刷新令牌, 它是一个用来获取access token的凭证 下面是 OAuth 2.0 中的 token 工作流程图 回归主题, 这两个令牌的主要区别如下

RayPick的博客 7042

道冲而用不盈,RAP 开发里的留白、节制与业务对象之道

摘要(148字) 老子"道冲"思想在SAP RAP开发中体现为"留白"的工程哲学:业务对象应如器皿保持中空,不被单一需求填满。RAP通过分层设计(CDS视图、行为定义、服务绑定)构建弹性架构,核心在于: 业务对象保持最小事务边界,非核心功能通过association/action扩展 Validation与Determination各司其职,避免代码臃肿 优先使用Managed模式,将持久化等重复逻辑交给框架 这种设计使同一BO能服务多场景,正如杯壁围出的空间决定其容

2007 年 ~ 2025 年,深耕 SAP 技术 18 年 2304

accessToken 和 refreshToken区别

accessToken和refreshToken关联和区别

Mr.绵羊的知识星球 3861

大语言模型在构建UNSPSC 分类数据中的应用

UNSPSC 是联合国标准产品和服务代码。本文研究如何利用大语言模型生成分类系统的分析

姚家湾博客 1913

Cursor插件安装CodeX保姆级教程:从登录到调整面板布局,一步不落

本文提供Cursor编辑器安装CodeX插件的详细教程,涵盖从登录到调整面板布局的全流程。通过优化界面布局和配置参数,帮助开发者提升编码效率,特别适合需要智能代码补全的编程场景。

weixin_42648844的博客 4805

访问令牌(AccessToken)与刷新令牌(RefreshToken)

源码点我 闲着无聊的我又来了,今天介绍一下访问令牌(AccessToken)与刷新令牌(RefreshToken)。 最近公司来了几个Java,然后空气顿时充满了学术的氛围,每天都弥漫着垃圾回收,内存分配,堆栈等等各种技术问题的讨论,竖起了我的小耳朵,我偶然间听到了这个Token过期的问题,今天来说一说。 众所周知,JWT是我们常用的Token类型之一,但是JWT是无状态的,所有的信息,包括超时时间都会编码在JWT中。如果Token设置的超时时间过长会显得有些不安全,如果设置的过短则必须频繁的登录。 在Id

昨夜丶雨疏风骤的博客 1万+

计算机组成原理实验:手把手教你用模拟程序实现中断机制(附完整代码)

本文通过一个计算机组成原理模拟实验,手把手教你从零实现一个可工作的中断系统。实验详细演示了如何配置中断控制器、编写主程序与中断服务程序,并观察中断响应、现场保护和恢复的全过程,深入解析了中断原理的核心机制。

478

php token过期时间,token过期是什么意思

代表证书等过期的意思。 (推荐学习:phpstorm)需要重新获取code,然后得到access_token, 即要重新调用授权界面,需要用refreshtoken刷新accesstoken。如果刷新取到了新的accesstoken、refreshtoken、expirein,需要用这些新的...

weixin_42354933的博客 1184

从零开始训练一个简单的CLIP

到这里,你已经基本了解了CLIP的基本原理,并且能够自己动手训练一个简单的CLIP模型。整体上来看,代码比较简单,但是已经基本覆盖到CLIP的整体训练流程了。另外,如果需要实际的落地,建议还是使用openclip等更加成熟的框架。欢迎关注github:https://github.com/taishan1994。

u012374012的专栏 2916

抖音用户评论和ID的采集方法

随着5G时代的普及,各大运营商的套餐纷纷推出,使得流量成本进一步降低。同时5G线路高宽带、低延迟的技术特性和手机普及,让视频用户访问量快速增加。 由于大量的视频工具和拍摄APP的提供,让短视频的拍摄、制作包括发行都变得更加简单便捷,越来越多的普通人可以投入视频创作,创造了更丰富的互联网内容,视频作者从视频推广中能获取粉丝和推广收益。 目前抖音就是目前最重要的短视频平台之一,要及时获取上面的用户评论和ID,需要结合爬虫代理实现采集方案,下面的代码就能快速采集相关信息: package htmlunit; i

ssbt_2020的博客 6797

Spring Security Oauth2 RedisTokenStore 类图

源码地址:RedisTokenStore.java 个人微信公众号: 作者:jiankunking 出处:http://blog.csdn.net/jiankunking

勿忘初心 1923

Ubuntu升级遇到grub-efi-amd64-signed安装失败?3步搞定这个烦人错误

本文深度解析Ubuntu系统升级时grub-efi-amd64-signed安装失败并提示“cannot find EFI directory”错误的根本原因。该错误通常由EFI系统分区挂载异常、BIOS/UEFI引导模式不匹配或dpkg包状态死锁导致。文章提供了三步精准修复流程:首先检查并修复ESP分区挂载,其次处理dpkg依赖问题,最后针对传统BIOS系统提供适配方案,帮助用户安全彻底地解决这一常见升级难题。

r7s8t的博客 405

OAuth 2.0授权框架详解

在现代的网站中,我们经常会遇到使用OAuth授权的情况,比如有一个比较小众的网站,需要用户登录,但是直接让用户注册就显得非常麻烦,用户可能因为这个原因而流失,那么该网站可以使用OAuth授权,借助于github或者其他的第三方网站的认证授权,来获取相关的用户信息,从而避免了用户注册的步骤。 当然,很可能在第三方网站上授权获得用户信息之后,还需要在本网站填写一些必要的信息进行绑定,比如手机号,用户名等等。 但是这比单纯的注册要方便太多了,也容易让用户接受。 今天,我们将要讲解一下OAuth 2.0授权框

程序那些事 1万+

嵌入式AI实战:基于RK3588部署YOLOv11并集成OpenCV实现实时推理(全流程详解)

本文详细介绍了在RK3588芯片上部署YOLOv11目标检测模型的全流程,包括环境搭建、模型转换和实时推理实现。主要内容为:1)通过YOLOv11官方工具将PyTorch模型转为ONNX格式;2)使用RKNN Toolkit2将ONNX模型转换为适配RK3588的RKNN格式;3)在RK3588上结合OpenCV实现实时视频推理功能。教程提供了完整的代码示例和详细步骤说明,帮助开发者快速在边缘设备上部署目标检测模型,实现AI视觉应用的落地。

LXY_LOVE36的博客 219

YOLOv8的二次创新 | 结合iRMB与EMA打造全新的iEMA机制,提升动态检测性能【附保姆级代码】

YOLOv8继承了YOLO系列的轻量化和高效检测特性,同时通过改进的架构设计使得其在实时场景下具有更高的检测精度。然而,随着检测需求的增加,尤其是在动态目标检测和长时间序列检测中,YOLOv8的鲁棒性依然可以提升。通过iEMA机制的引入,我们将在这些方面进行进一步优化。iRMB模块是我们对传统Residual Block的进一步改进。通过多层特征提取,iRMB能够捕捉更多层次的特征信息,并通过引入轻量化的残差结构,提升计算效率。

一键难忘的博客 3088

IdentityServer4专题之四:Authorization Endpoint、Token Endpoint、scope、Access Token和Refresh Token、授权服务器发生错误...

1.Authorization Endpoint 它是与用户交互的端点,用户在此进行为客户端应用授权的操作,即authorization grant 2.Token Endpoint 端点,就是一个web服务,一个路径,一个uri。客户端应用向Token端点展示它的权限,即展示authrization grant或者refresh token,来获取access token.除了implic...

weixin_30810239的博客 812

IEM模型,地表粗糙度模拟

利用微波反演土壤水分时候,利用IEM模型可以实现对随机地表的模拟

实现JWT刷新机制以及让过期时间更精确

借助accessToken和refreshToken实现 accessToken控制刷新间隔,refreshToken控制最长过期时间 Min过期时间 = refreshToken过期时间 - accessToken过期时间 Max过期时间 = refreshToken过期时间 实际过期时间是一个范围,在(Min过期时间 ~ Max过期时间)之间 如...

aiqiushan4132的博客 2474

精雕软件(JDpaint) 5.5 绿色版

精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版精雕软件(JDpaint) 5.5 绿色版

数学建模模型总结

这是本人在两年内准备参加数学建模竞赛搜集到的模型资料,已经经过了本人的筛选和整理,希望能够对准备参加数学建模竞赛的学弟学妹们提供一些帮助!

Cursor与Windsurf令牌存储之争:Cookie和IndexedDB谁更安全可靠?

在AI编程工具和Electron桌面应用中,登录状态管理一直是个容易被忽略却至关重要的技术细节。其核心在于会话凭证(Token)的持久化方案:传统Web环境习惯将Token置于Cookie中,让浏览器在请求时自动携带;而IndexedDB作为一种浏览器内置的非关系型数据库,提供了更大的存储空间和更灵活的读写控制。两种方案在CSRF防护、XSS风险、清理误伤率以及会话恢复流程上各有取舍。理解这些技术原理,不仅有助于排查Cursor或Windsurf常见的登录掉线、token exchange failed等故

weixin_42533120的博客 290

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

OAuth有一些定义:

OAuth有一些定义:OAuth 2.0是一个委托协议, 它可以让那些控制资源的人允许某个应用以代表他们来访问他们控制的资源, 注意是代表这些人, 而不是假冒或模仿这些人. 这个应用从资源的所有者那里获得到授权(Authorization)和access token, 随后就可以使用这个access token来访问资源.(这里提到的假冒或模仿就是指在客户端复制一份用户名和密码,从而获取相应的权限...

li123128的博客 940

Spring Security OAuth令牌管理:AccessToken与RefreshToken详解

在OAuth 2.0认证协议中,AccessToken(访问令牌)和RefreshToken(刷新令牌)是安全认证的核心组件。Spring Security OAuth框架提供了完整的令牌管理解决方案,让开发者能够轻松实现安全的API访问控制。本文将深入解析这两种令牌的作用、生命周期和最佳实践。🚀 ## 什么是AccessToken与RefreshToken? **AccessToken**

gitblog_00503的博客 1168

Web开发茶话会_accessToken和refreshToken

《Web开发茶话会》系列文章的专注于Web开发过程中的重点难点,采取:应用示例+分析+小试牛刀的模式,让读者先有个感性认知,再分析解释知识点,最后抛出一个两个问题,加深理解。此系列文既谈技术,也谈“风月”,请读者备好茶水。

wuxeek的博客 591

access token已过期,怎么用refreshtoken刷新accesstoken

access token已过期,怎么用refreshtoken刷新accesstoken。 不指定 justwinit 2014-2-17 16:13 大 | 中 | 小 WEB2.0 评论(0) 需要重新获取code,然后得到access_token。 即要重新调用授权界面。需要用refreshtoken刷新accesstoken。 如果刷新取到了新的accesstoken、...

xls51314202005的博客 3993

企业认证与安全体系(一):为什么企业都在用双 Token 机制?一篇讲透 AccessToken、RefreshToken 与企业级认证体系

企业级认证体系的核心在于双Token机制(AccessToken+RefreshToken),通过短期有效的AccessToken(30分钟-2小时)降低泄露风险,配合RefreshToken实现无感续签。RefreshToken需设置有效期(通常7天)并存储于Redis而非JWT,以支持主动撤销和安全管控。典型实现包含JWT+Redis组合、Token轮换机制和自动续签流程,同时延伸出OAuth2、权限管理等完整安全体系。该设计平衡了安全性与用户体验,解决了传统Session的扩展性问题,形成包含会话生命

Mark Wu 的博客 546

移动端登录态安全设计(2):Token 拿到后,为什么不能明文存?

移动端Token安全存储最佳实践:避免明文存储,采用AES-GCM加密结合Android Keystore保护密钥。文章指出Token本质是用户身份凭证,若泄露将导致账户被盗用。建议将accessToken(短期)和refreshToken(长期)分开处理,后者需重点保护。通过加密存储、内存缓存、日志脱敏等多层防护,并配合后端Token失效机制,构建完整安全闭环。关键点是:先加密再存储(AES-GCM),密钥由Keystore保管,DataStore/MMKV仅存密文,运行时解密使用。同时需处理旧版本迁移、

Mark Wu 的博客 544

Android企业级网络架构实战:一套完整的双Token认证解决方案 ——(401自动续期|请求重放|RefreshToken刷新|并发401治理)

本文介绍了一套Android企业级双Token认证方案,重点解决传统单Token机制在复杂场景下的问题。方案采用AccessToken(短期)和RefreshToken(长期)双Token机制,通过以下核心组件实现: TokenManager统一管理Token状态,包含内存缓存和持久化存储 TokenAuthInterceptor拦截请求和401响应,实现自动续期和请求重放 独立RefreshRetrofit避免拦截器循环 TokenRefresher处理并发刷新,采用synchronized+锁内二次检查

Mark Wu 的博客 1495
上一篇: 彻底搞懂promise问题
下一篇: Flutter 完整学习文档 - 从入门到精通
zwjapple
博客等级 码龄15年 256粉丝 194原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值
⌂ 换网址