TP8.0 基于 JWT 实现前后端分离下的无状态鉴权【Stateless】

夏敏酱_3998

夏敏酱_3998

2026-07-16

167人浏览

原创

ThinkPHP 8.0 实现 JWT 无状态鉴权需严格遵循“不存 session、不查库验身份、每次请求独立验证”原则,同时必须补足黑名单(Redis 存储 jti)、iss/aud 发行方与受众校验、认证与鉴权分离(AuthCheck 与 PermissionCheck 中间件解耦)等关键环节,否则存在登出延迟、跨模块越权、中间件绕过等安全风险。

tp8.0 基于 jwt 实现前后端分离下的无状态鉴权【stateless】

ThinkPHP 8.0 实现 JWT 无状态鉴权,核心在于“不存 session、不查库验身份、每次请求独立验证”,但必须补足黑名单、发行方校验、权限解耦等关键环节,否则看似无状态,实则存在登出失效延迟、跨模块越权、中间件绕过等风险。

Token 生成要带必要字段和安全约束

生成 JWT 时不能只塞 uid 和 exp。payload 至少应包含:

  • iss(Issuer):固定为你的 API 域名(如 https://api.example.com),用于防止 token 被其他系统复用;
  • aud(Audience):按业务区分,比如 user 或 admin,鉴权中间件需比对当前请求所属模块;
  • jti(JWT ID):服务端生成唯一值(如 uniqid(true)),作为后续黑名单 key;
  • exp:合理设置(如 2 小时),避免过长导致风险窗口扩大;
  • 不存敏感信息:密码、手机号、身份证号等禁止写入 payload。

验证流程必须前置黑名单与标准字段校验

TP8 的中间件中,JWT 解析不能只调 JWT::decode()。正确顺序是:

ThinkPHP5.1企业站点快速开发-源码课件
ThinkPHP5.1企业站点快速开发-源码课件

ThinkPHP5.1企业站点快速开发

下载
  • 从 Authorization: Bearer xxx 提取 token;
  • 先用 JWT::getHeader($token) 检查 alg 是否为 HS256(禁用 none 算法);
  • 再用 JWT::decode($token, new Key($secret, 'HS256')) 解析;
  • 立即检查 iss 和 aud 是否匹配当前配置;
  • 查询 Redis 中 jwt:blacklist:{jti} 是否存在,存在则直接返回 401;
  • 最后才将用户 ID 和角色信息写入 think\facade\Request::with('auth', [...]) 供后续使用。

黑名单必须用 Redis 主动管理

TP 默认缓存驱动(如 file 或 apcu)不支持原子操作,高并发下黑名单可能失效。生产环境必须:

  • 使用 Redis 存储黑名单,key 格式统一为 jwt:blacklist:{jti};
  • 设置 TTL 与 token 过期时间完全一致(如 7200 秒);
  • 登出接口或密码修改后,主动执行 Redis::setex('jwt:blacklist:'.$jti, $ttl, 1);
  • 避免用 think\facade\Cache 替代 Redis,尤其在集群部署时。

鉴权逻辑必须与认证分离

TP8 的 Auth 中间件只做身份认证(Authentication),不是权限控制(Authorization)。真正的鉴权要单独写中间件:

  • 在 app/middleware/AuthCheck.php 中完成 token 解析与黑名单校验;
  • 另建 app/middleware/PermissionCheck.php,根据路由或注解读取所需权限(如 @permission('user:edit'));
  • 权限数据建议从 Redis 缓存加载(如 user:perms:{uid}),而非每次查数据库;
  • 控制器里禁止写 if ($user->role !== 'admin') { ... },所有判断统一收口到 PermissionCheck。

相关文章

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

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

下载

相关标签:

thinkphp thinkphp 8.0

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

相关专题

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

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

2023.08.11

3063

5

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

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

2024.03.19

7570

13

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

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

2024.03.19

7166

10

Sass和less的区别
Sass和less的区别

Sass和less的区别有语法差异、变量和混合器的定义方式、导入方式、运算符的支持、扩展性等。本专题为大家提供Sass和less相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.12

3387

5

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

140

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

100

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

160

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

140

13

热门下载

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

精品课程

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