现象:页面直接 500,日志只有一行 2002
PHP 8 环境下跑 Laravel、ThinkPHP 或 Z-Blog,数据库突然连不上,日志里是这两行之一:
SQLSTATE[HY000] [2002] Connection refused
SQLSTATE[HY000] [2002] No such file or directory
两个报错处在同一个阶段:客户端还没连上 MySQL,账号密码根本没进入校验。所以改密码、重建用户都不会有效果。
原因:只和三件事有关
- MySQL 没在跑,或只监听 127.0.0.1 而程序连的是内网 IP,报 Connection refused。
- DSN 写了 localhost,PHP 会走 unix socket,路径和 MySQL 实际 socket 不一致时报 No such file or directory。
- 防火墙或安全组没放行 3306,本机连本机同样会被拒绝。
解决步骤
第一步,确认服务和端口。
systemctl status mysqld
ss -lntp | grep 3306
第二步,对比 socket 路径,两处必须是同一个文件。
mysql -e "select @@socket;"
php -i | grep -i pdo_mysql.default_socket
第三步,DSN 改成 127.0.0.1 走 TCP,绕开 socket 路径问题,并加上超时。
$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=blog';
$pdo = new PDO($dsn, 'user', 'pass', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_TIMEOUT => 3,
]);
第四步,确认端口没被改过。改过端口的话,配置文件、防火墙、安全组要一起同步。
小结
2002 属于通讯层错误,和账号权限无关。按服务状态、socket 路径、监听地址和端口依次排查,几分钟就能定位;等报错变成 1045,才轮到密码和授权。
