ThinkPHP数据库报错怎么修_ThinkPHP连接失败排查指南【说明】-ThinkPHP-PHP中文网

应先查看PDOException的message字段获取真实错误：如[2002]表示服务未启动或网络不通，[1045]为认证失败，[2002]加“No such file”则指向socket路径问题；再针对性排查host、port、env加载及MySQL 8.0认证插件等。

thinkphp数据库报错怎么修_thinkphp连接失败排查指南【说明】

报错不是配置写错了就是 PDO 根本没连上，先看 PDOException 的 message 字段，再动手改配置或重启服务。

ThinkPHP 不会自己造错，它只是把 PDO 抛出来的异常原样往上扔。关键就藏在 message 里：

"SQLSTATE[HY000] [2002] Connection refused" → MySQL 没启动，或 host/port 对不上
"SQLSTATE[HY000] [1045] Access denied for user" → 用户名密码错，或该用户不允许从当前 host 连入（比如数据库里是 'user'@'localhost'，但 PHP 跑在 Docker 容器里）
"SQLSTATE[HY000] [2002] No such file or directory" → 配置写了 localhost，但 MySQL 没开 socket，或路径不对（常见于 Mac M1 Homebrew 安装）

别只盯着 ThinkPHP 日志里“数据库连接失败”这句废话，直接翻 runtime/log/ 下最新日志，找到带 PDOException 的那一行，复制完整 message 再判断。

常见错位点不在配置语法，而在网络语义：

host 别写 localhost：它在多数系统下强制走 Unix socket；而你配的 port 是给 TCP 用的，两者不匹配。统一用 127.0.0.1 测试
port 必须是整数：写成 '3306'（字符串）会导致 ThinkPHP 5.1+ 传给 PDO 时类型不符，PDO 会静默 fallback 到默认端口
Docker 环境中，host 不能写 127.0.0.1 或 localhost，得换成容器名（如 mysql）或宿主机网关（如 host.docker.internal）
云服务器上，MySQL 用户的 host 字段必须是 '%' 或具体公网 IP，不能是 'localhost' —— 否则远程请求直接被拒

.env 不是写了就能用，它有三个硬性前提：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

验证是否加载成功，控制器里临时加一行：dump(env('DB_HOST'));。输出 null 就说明上面三点至少有一条没满足。

错误信息是：Authentication plugin 'caching_sha2_password' cannot be loaded。这不是 ThinkPHP 的锅，是 PHP 7.4 以下版本的 PDO 不支持 MySQL 8.0 默认认证方式。

别降级 MySQL，也别强行换驱动 —— 直接改用户认证方式更稳
登录 MySQL 执行：ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
执行完记得 FLUSH PRIVILEGES;
如果用户是 'your_user'@'localhost'，就把 '%' 换成 'localhost'

这个操作只影响指定用户，不影响其他用户或全局安全策略。改完立刻重试，不用重启 MySQL。

真正难排查的从来不是“连不上”，而是“看起来连上了，但第一次查询就卡住或超时”——这时候大概率是 DNS 解析慢、MySQL 的 wait_timeout 太短，或者事务闭包里漏掉了 commit/rollback，导致连接一直被占着不放。