前端报 403 Forbidden?ThinkPHP 6.0 CSRF 令牌刷新与白名单机制【表单】

星夢妙者

星夢妙者

2026-07-18

573人浏览

原创

thinkphp 6.0 表单提交突然 403 是因 csrf 令牌过期或不匹配,非权限问题而是中间件拦截;默认 token 存于 session、有效期 3600 秒,页面刷新即更新 token,旧页提交旧值或 ajax 未正确传 token 均触发 403。

前端报 403 forbidden?thinkphp 6.0 csrf 令牌刷新与白名单机制【表单】

为什么表单提交突然 403?CSRF 令牌过期或不匹配

ThinkPHP 6.0 默认开启 CSRF 防护,form 提交时若 _token 缺失、过期或与 session 中的不一致,就会返回 403 Forbidden。这不是权限问题,而是中间件拦截了非法请求。常见于页面长时间未操作后提交、AJAX 重复提交、或页面缓存了旧 token。

  • TP6 的 CSRF token 存在 session 中,有效期默认 3600 秒(可配 csrf.expire
  • 每次刷新页面,token() 函数会生成新 token 并更新 session;但旧页面里的 hidden input 仍用旧值
  • 如果用户开多个标签页共用同一 session,其中一个页刷新了 token,其他页再提交就会 403

如何安全刷新表单中的 CSRF token?

不能只靠 JS 定时重拉,也不能每次提交都先 GET 一次 token 接口——这破坏幂等性且增加并发风险。正确做法是:在表单渲染时生成 token,并在关键交互(如弹窗打开、tab 切换)后主动更新 DOM 中的 _token 值。

PHP 8.5.5
PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。

下载
  • 服务端用 token() 输出初始值:
    <input type="hidden" name="_token" value="<?= token() ?>">
  • 前端 JS 可封装一个刷新函数,调用 /api/csrf-token(需路由允许 GET 且不校验 CSRF)返回新 token:
    fetch('/api/csrf-token').then(r => r.json()).then(data => { document.querySelector('[name=_token]').value = data.token; });
  • 该接口只需简单返回 ['token' => token()],无需额外验证,但必须加白名单路由(见下节)

怎么给特定接口/路由关闭 CSRF 校验?

TP6 的 CSRF 中间件(think\middleware\CheckRequestCachethink\middleware\ValidateToken)默认全局启用。要跳过某接口,不能删中间件,而应在路由定义中显式关闭。

  • route/app.php 中,对需要放行的路由使用 ->middleware('csrf:false')
    Route::post('upload', 'Index/upload')->middleware('csrf:false');
  • 注意:不是 ->withoutMiddleware('csrf'),TP6 不支持这种写法;csrf:false 是中间件参数,由框架识别
  • 白名单仅适用于「不需要用户态身份凭证」的接口,比如上传回调、Webhook 接收,切勿对修改数据的普通表单接口关闭

为什么 AJAX 提交也报 403?header 和 token 都得对上

表单 submit 自动带 _token 字段,但 AJAX 默认不附带。即使你手动加了 _token 字段,如果同时设置了 Content-Type: application/json,TP6 的 ValidateToken 中间件会跳过解析 POST 数据(因为 JSON 不走 $_POST),导致 token 检查失败。

  • 方案一(推荐):保持 Content-Type: application/x-www-form-urlencoded,把 token 放在 body:
    fetch('/submit', { method: 'POST', body: new URLSearchParams({ title: 'x', _token: document.querySelector('[name=_token]').value }) });
  • 方案二:改服务端逻辑,在中间件里手动解析 JSON body(不推荐,破坏框架约定)
  • 方案三:用 X-CSRF-TOKEN 请求头(需前端读取 meta 或自定义 header,后端需额外适配,TP6 默认不支持)
CSRF 机制本身不复杂,但 token 生命周期、前后端协作方式、以及中间件执行时机这几个点一旦错位,就容易卡在 403 上查半天。最常被忽略的是:token 值变了,但 DOM 没同步;或者关错了中间件开关,误以为关掉了其实没生效。

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

相关文章

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

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

下载

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

相关专题

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

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

2023.08.11

1111

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

2285

6

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

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

2024.03.19

2155

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

2346

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

357

5

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

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

2023.09.01

5551

6

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

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

2023.10.11

3630

5

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

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

2023.10.11

1808

5

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

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

2023.10.23

2295

4

热门下载

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

精品课程

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