thinkphp数据库连接失败需分层验证：先用mysql -h 127.0.0.1 -p 3306 -u root -p直连确认服务状态；再查.env位置、app_debug开关及键名格式是否正确；接着核对mysql用户host权限匹配性；最后处理mysql 8.0+ caching_sha2_password认证兼容问题。
ThinkPHP部署后数据库连接失败，核心不是改配置，而是分层验证：先确认底层服务通不通，再看框架是否读到正确参数，最后检查权限和兼容性是否匹配。
第一步：绕过框架直连 MySQL
别急着打开 database.php，先在服务器上执行：
- mysql -h 127.0.0.1 -P 3306 -u root -p —— 用 IP 而非 localhost，强制走 TCP，避免 Unix socket 干扰
- 如果连不上，说明 MySQL 没启动、端口被拦，或 bind-address 配置限制了访问
- 若能连上，再试 mysql -h localhost -u root -p，对比行为差异——这能快速判断是 host 解析问题还是权限绑定问题
第二步：确认 ThinkPHP 实际加载的配置
.env 文件常被误放或忽略，导致配置没生效：
- .env 必须放在项目根目录（与 think 命令同级），不能在 config/ 或 app/ 下
- APP_DEBUG 必须为 true，否则环境变量不加载
- 键名必须全大写加下划线，如 DB_HOST=127.0.0.1，写成 db_host 或 DB-host 都无效
- 控制器里加一行 dump(env('DB_HOST'));，输出 null 就说明前三点至少有一条不满足
第三步：查清 MySQL 用户权限实际绑定的 host
报 Access denied for user，90% 是 host 不匹配：
- 进 MySQL 执行：SELECT User, Host FROM mysql.user WHERE User = 'your_user';
- 若结果是 'user'@'127.0.0.1'，那 PHP 配置里 host 就必须是 127.0.0.1，写 localhost 会失败
- 若部署在 Docker，host 应填容器名（如 mysql），对应权限记录就得是 'user'@'mysql' 或 'user'@'%'
- 授予权限后务必执行 FLUSH PRIVILEGES;，否则不生效
第四步：处理 MySQL 8.0+ 认证插件不兼容
报错含 caching_sha2_password，说明 PHP 版本较低（
- 不要降级 MySQL，改用户认证方式即可：
- ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
- 或针对本地连接：ALTER USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'xxx';
- 执行后重连测试，无需重启 MySQL
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
