ThinkPHP前后端分离Token刷新机制怎么正确实现

小枫小哥_5608

小枫小哥_5608

2026-08-01

167人浏览

原创

ThinkPHP前后端分离中Token刷新机制真正可用的关键在于Access Token与Refresh Token的职责分离、存储方式匹配及异常流程闭环。Access Token短期有效仅用于API校验,Refresh Token长期有效专用于刷新接口,二者须物理隔离、密钥独立;后端刷新需验证签名、查黑名单、轮换令牌并安全设置Cookie;前端拦截器应实现“一次失败、一次重试、一次终止”三级响应处理;CORS配置须与认证方式对齐,避免跨域问题。

thinkphp前后端分离token刷新机制怎么正确实现

ThinkPHP前后端分离中,Token刷新机制要真正可用,关键不是“有没有刷新接口”,而是Access Token 和 Refresh Token 的职责分离、存储方式匹配、异常流程闭环。很多项目卡在前端重试失败、后端黑名单失效或跨域 Cookie 丢失上,本质是没理清这三者的协同逻辑。

Access Token 与 Refresh Token 必须物理隔离

不能只用一个 JWT 做“过期就刷新”——那是伪刷新,安全风险高。必须拆成两个独立令牌:

  • Access Token:短期有效(建议 15–60 分钟),仅用于 API 请求校验,payload 中不存敏感字段,签名密钥与 Refresh Token 不同
  • Refresh Token:长期有效(如 7 天),只用于调用 /api/refresh 接口换新 Access Token,绝不参与任何业务接口校验
  • 两者生成时应使用不同密钥(如 JWT_ACCESS_SECRET 和 JWT_REFRESH_SECRET),避免单点泄露导致全盘失守

后端刷新接口必须带状态控制与黑名单兜底

刷新不是简单签发新 Token,而是一次受控的凭证置换:

Build MCP servers and clients for PHP applications with the official PHP SDK
Build MCP servers and clients for PHP applications with the official PHP SDK

使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

下载
  • 接收 Refresh Token 后,先用 JWT_REFRESH_SECRET 验证其签名和未过期;再查 Redis 中是否存在该 token 的哈希值(如 refresh:blacklist:{sha256($rt)}),已拉黑则直接拒绝
  • 验证通过后,生成新的 Access Token(含新 exp)和新的 Refresh Token(可轮换,旧 Refresh Token 立即加入黑名单)
  • 响应体返回新 Access Token;新 Refresh Token 必须设为 httpOnly + Secure + SameSite=Strict 的 Cookie(ThinkPHP 中用 $this->response->cookie() 设置),禁止前端 JS 读取
  • 原 Refresh Token 过期后自动失效,无需主动删除;但用户登出时需手动写入黑名单并清除 Cookie

前端拦截器要处理“一次失败、一次重试、一次终止”三级响应

别依赖全局 401 拦截自动刷新——它容易陷入无限循环或覆盖用户真实错误:

  • 请求发出前:从内存读 Access Token,填入 Authorization: Bearer xxx;Refresh Token 不读,由浏览器自动随 Cookie 发送
  • 响应收到后:
    → 若状态码为 401 且响应 body 中有 {"code": 401, "message": "token_expired"},说明 Access Token 过期,触发刷新流程
    → 若刷新接口返回 200,更新内存中的 Access Token,并用新 Token 重发原请求
    → 若刷新接口也返回 401(Refresh Token 失效),清空本地所有凭证,跳转登录页
  • 特别注意:Axios 的 originalRequest._retry = true 标记必须严格生效,避免同一请求被重复刷新多次

CORS 与认证头必须对齐实际传输方式

JWT 场景下,不要开启 withCredentials: true 除非你真要用 Cookie 存 Access Token:

  • 推荐方案:Access Token 走 Header(Authorization),Refresh Token 走 httpOnly Cookie —— 此时 CORS 配置中 'allow_credentials' => false 即可,origin 可设为具体域名列表
  • 若坚持双 Cookie 方案,则 allow_credentials 必须为 true,且 origin 不能为 *,同时 ThinkPHP 中需确保中间件顺序正确(Cors → JwtAuth)
  • 所有 API 路由必须显式声明中间件,例如:Route::group('api', function () { Route::post('refresh', 'Api/Auth::refresh')->middleware('thans\jwt\middleware\JWTRefresh::class'); });

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

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

下载

相关标签:

thinkphp php

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

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3143

5

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7710

13

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7346

10

php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

13384

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

7641

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2295

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4828

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

5554

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

4371

9

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程