ThinkPHP报SQLSTATE[HY000]错误及数据库服务器连通性检测-ThinkPHP-PHP中文网

PDO错误模式未设为异常模式导致SQLSTATE[HY000]掩盖真实原因；需配置PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，并区分host语义、用php -r直连验证。

thinkphp报sqlstate[hy000]错误及数据库服务器连通性检测

查不到具体错误原因？先看 `PDO::ATTR_ERRMODE` 是否设为异常模式

ThinkPHP 默认用 PDO 连接数据库，但 PDO 的错误处理默认是静默的——出错只返回 false，不抛异常，所以你看到的 SQLSTATE[HY000] 往往只是“连接失败”的笼统代号，背后可能是密码错、端口不通、用户没权限，甚至 MySQL 服务根本没起来。

在 database.php 配置里加这一行，强制 PDO 报详细错误：

'params' => [
    \PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION,
],

不加这行，ThinkPHP 只会吐出 SQLSTATE[HY000]，你得靠猜
加了之后，错误信息会变成类似 SQLSTATE[HY000] [2002] Connection refused 或 Access denied for user 'xxx'@'localhost'，直接定位问题类型
注意：上线环境别留着，否则可能泄露敏感信息；开发/测试阶段务必打开

连得上 MySQL 但还是报 HY000？检查 `host` 和 `unix_socket` 冲突

常见于本地开发（尤其是 macOS / Linux），配置里写了 'host' => '127.0.0.1'，但 MySQL 实际监听的是 socket 文件（比如 /tmp/mysql.sock）。PDO 会优先走 socket 连接，而 127.0.0.1 强制走 TCP，结果就是“地址对但连不上”，报 HY000。

确认 MySQL 实际监听方式：mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';" 看 socket 路径；再执行 netstat -an | grep :3306 看是否监听 TCP
如果只开 socket，就把 host 改成 'localhost'（注意：不是 127.0.0.1）——PDO 对 localhost 会自动走 socket
如果必须走 TCP（比如容器环境），确保 host 是 '127.0.0.1'，且 MySQL 的 bind-address 没被设成 127.0.0.1 以外的值（如 0.0.0.0 或注释掉）

用 `php -r` 快速验证连通性，绕过 ThinkPHP 层

别急着改代码或配文件，先用最简 PHP 命令直连数据库，确认是环境问题还是框架配置问题：

php -r "\$pdo = new PDO('mysql:host=127.0.0.1;port=3306;dbname=test', 'root', 'password'); echo 'OK';"

如果这行报错，说明是 PHP、MySQL、网络或凭据问题，和 ThinkPHP 无关
如果这行成功，但 ThinkPHP 还报 HY000，大概率是配置里的 host/port/username 写错了，或者用了 .env 里未生效的变量（比如忘记运行 php think optimize:config）
注意：命令中端口要和配置一致；如果 MySQL 改过默认端口（比如 3307），这里必须显式写上 port=3307

容器或远程部署时，`host` 别写 `localhost`

在 Docker 或云服务器上，ThinkPHP 应用和 MySQL 不在同一个进程空间。localhost 在容器内指向本容器 loopback，不是宿主机或另一容器——所以连的其实是空的 127.0.0.1，必然失败。

Docker Compose 场景：MySQL 容器名是 mysql，那 ThinkPHP 的 host 就得填 'mysql'，不是 'localhost' 或 '127.0.0.1'
阿里云 RDS / 腾讯云 CDB：host 填控制台给的外网或内网地址（如 xxx.mysql.rds.aliyuncs.com），端口通常是 3306，但有些实例会限制白名单，记得加服务器 IP 到安全组
本地 WSL2 访问 Windows 上的 MySQL：host 填 host.docker.internal（Docker Desktop）或 192.168.1.x（查 Windows 主机真实 IP），不能填 localhost