ThinkPHP权限验证失败主因是MySQL认证失败（1045错误）、.env未生效、host不匹配（localhost≠127.0.0.1）、MySQL 8+ caching_sha2_password插件不兼容、runtime目录权限不足或中间件未正确绑定。
ThinkPHP权限验证失败，通常不是代码逻辑出错，而是环境配置、用户权限或认证机制不匹配导致的。关键要分清是“数据库连接拒绝”还是“应用层鉴权拦截”，两者处理路径完全不同。
检查MySQL认证失败（报错含1045）
看到 SQLSTATE[HY000] [1045] Access denied for user，说明MySQL明确拒接了凭证，和ThinkPHP本身无关：
- 确认
.env文件在项目根目录，且APP_DEBUG=true、键名全大写加下划线（如DB_PASSWORD），否则env()返回null - 在控制器里加
dump(env('DB_HOST')); dump(env('DB_USERNAME'));，看是否真读到了配置 -
localhost和127.0.0.1在MySQL中是两个独立host，权限不通用；若用TCP连接（ThinkPHP默认），就别依赖'root'@'localhost'，改用'root'@'127.0.0.1'并刷新权限 - MySQL 8+ 默认用
caching_sha2_password插件，旧版PHP（尤其未更新mysqlnd）不支持；可临时改用户认证方式：ALTER USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'yourpass';
修复runtime目录写入权限问题
缓存、日志、模板编译写不进 runtime/，会导致中间件加载失败、路由解析异常，间接表现为“权限验证没生效”：
- 先查PHP进程真实用户：Linux/macOS 运行
ps aux | grep php-fpm，Windows 查IIS服务登录账户或XAMPP控制面板中Apache运行身份 - 把
runtime/目录属主设为该用户，例如Ubuntu下：sudo chown -R www-data:www-data runtime/ - 目录权限设为
755，文件自动继承644；禁用chmod 777，它在SELinux或Nginx安全策略下反而被拒绝 - CentOS/RHEL启用SELinux时，需额外执行：
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/path/to/runtime(/.*)?"; sudo restorecon -Rv /path/to/runtime
验证路由中间件是否真正绑定
权限控制靠中间件，但“写了中间件名”不等于“起了作用”：
立即学习“PHP免费学习笔记（深入）”；
- 路由组必须显式调用
->middleware('check_auth')，只在控制器构造函数或全局配置里注册中间件是无效的 - 中间件内取参数要用
$request->param('id')，而非$request->route()->param('id')——因为中间件执行时路由尚未完全解析 - 嵌套路由组时，外层中间件比内层先执行、后退出，权限叠加逻辑容易错乱；建议扁平化分组或用统一入口中间件
- 测试中间件是否触发：在handle方法开头加
file_put_contents(runtime/log/test.log, 'auth run', FILE_APPEND);，看日志是否生成
排除Web服务器与PHP配置干扰
有些“权限失败”其实是环境隔离造成的假象：
- CLI（
php think）和Web（浏览器访问）可能使用不同PHP配置；对比php -i | grep 'Loaded Configuration File'和phpinfo()输出是否一致 - Web根目录必须指向
public/，否则自动加载失败，连中间件类都找不到，自然无权限校验 - 检查
open_basedir是否限制了runtime/路径；临时注释该行测试是否恢复 - Windows下确保
IIS_IUSRS或对应用户对runtime文件夹有“修改”权限（右键→属性→安全→编辑）
