Laravel JWT多用户 token过期自动续期解决方案

老明吖_6577

老明吖_6577

2026-08-15

909人浏览

原创

Laravel多用户JWT自动续期需隔离token来源、采用双token机制并严格校验上下文:各模型在getJWTCustomClaims()中注入type标识,refresh接口按type路由guard,refresh_token存Redis并绑定type与user_id,中间件静默续期且每次刷新后失效旧token。

laravel jwt多用户 token过期自动续期解决方案

在 Laravel 中使用 JWT 实现多用户(如 Admin、User、Merchant 等不同模型)时,token 过期自动续期不能只依赖默认的单表逻辑——否则会出现越权问题(比如用户 token 可访问管理后台),且原生 tymon/jwt-auth 不自动支持多模型隔离续期。核心解法是:**区分 token 来源 + 双 token 机制 + 按用户类型隔离存储 + 续期时严格校验上下文**。

多用户 token 隔离:必须加自定义 claim

默认 JWT 的 sub 字段只存 ID,无法区分是哪个模型的用户。必须在签发时写入模型标识:

  • 在各用户模型(如 App\Models\Admin)中重写 getJWTCustomClaims():
public function getJWTCustomClaims()
{
  return [
    'type' => 'admin', // 或 'user', 'merchant'
    'model' => self::class,
  ];
}
  • 续期接口(如 /api/token/refresh)收到请求后,先解析原始 token 的 type 声明,再决定调用哪个 guard(如 auth:admin 或 auth:api)进行验证和刷新;
  • 拒绝处理 type 与当前请求路由不匹配的 token(例如管理端接口只接受 type=“admin” 的 token)。

安全续期流程:refresh token + 后端状态校验

不推荐纯前端定时刷新或无状态自动延长(违背 JWT 安全原则)。应采用带服务端状态的 refresh token 方案:

大模型Token成本节约
大模型Token成本节约

大模型 Token 成本节约工具。在请求到达大模型之前自动压缩 prompt 和上下文,减少 60-95% 的 token 消耗,直接降低 API 成本。支持 Claude/OpenAI/Gemini 等主流模型,提供代理模式、CLI 包装、Python SDK 和 MCP Server 四种接入方式。内置一键安...

下载
  • 登录成功时,除返回 access_token(15–30 分钟),还生成一个长期有效的 refresh_token(7 天),存入 Redis,key 为 refresh:{type}:{user_id},value 为加密后的随机字符串;
  • access_token 过期后,前端携带它和 refresh_token 请求 /api/token/refresh;
  • 后端验证:
     ✓ refresh_token 是否存在于 Redis 且未被撤销
     ✓ 原 access_token 的 type 和用户 ID 是否与 refresh_token 记录一致
     ✓ 用户当前是否仍处于激活/未禁用状态;
  • 全部通过才签发新 access_token,并更新 refresh_token 的 Redis 过期时间(滚动刷新)。

拦截器中实现无感续期(对前端透明)

在自定义中间件(如 EnsureTokenValid)中,当捕获 TokenExpiredException 时,不直接返回 401,而是尝试静默续期:

  • 从请求头取出 Authorization: Bearer xxx 和可选的 X-Refresh-Token;
  • 若含有效 refresh_token 且签名、类型、用户状态均合法,则生成新 access_token;
  • 将新 token 放入响应头 X-Access-Token,并设置 Refresh-Token 响应头(可选);
  • 继续执行后续逻辑(无需中断请求)——前端收到新 token 后可自动覆盖本地存储。

防滥用关键细节

避免 refresh token 泄露后被长期利用:

  • 每次成功刷新后,立即 失效旧 refresh token(Redis DEL),并生成新值;
  • 记录每个用户的 refresh token 使用次数和最近 IP/UA,异常频次触发风控(如锁定该用户 refresh 能力 1 小时);
  • 敏感操作(如修改密码、绑定手机)强制要求重新登录,不走 refresh 流程;
  • 所有 refresh 接口启用频率限制(如 5 次/小时/用户),防止暴力探测。

相关文章

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

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

下载

相关标签:

laravel token

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

相关专题

更多
php文件怎么打开
php文件怎么打开

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

2023.09.01

11824

6

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

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

2023.10.11

6801

5

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

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

2023.10.11

2195

5

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

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

2023.10.23

4308

4

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

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

2023.10.23

5034

6

html怎么上传
html怎么上传

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

2023.11.03

3951

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5697

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4462

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12362

4

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 218人学习

Composer手册
Composer手册

共0课时 | 0人学习