MySQL PDO 连接失败时 PDOException
报错内容怎么看
PDO 连接失败几乎总抛出
PDOException，关键不是看“连接失败”四个字，而是看
$e->getMessage()里紧跟的错误码和描述。常见如：
SQLSTATE[HY000] [1045] Access denied for user...表明认证失败；
SQLSTATE[HY000] [2002] No such file or directory通常指向 Unix socket 路径错误或
localhost被解析为 socket 连接；
SQLSTATE[HY000] [2003] Can't connect to MySQL server on 'xxx'则是网络层不通。
实操建议：
用var_dump($e->getCode(), $e->getMessage())明确错误类型，别只 echo $e 检查 DSN 中的 host 是否写成
localhost却期望走 TCP：改用
127.0.0.1强制 IPv4 若用 socket（如
unix_socket=/var/run/mysqld/mysqld.sock），确认路径真实存在且 PHP 进程有读权限
DSN 中 host
、port
、unix_socket
的优先级与冲突
PDO MySQL 驱动对连接参数有隐式优先级：当 DSN 同时指定
host=localhost和
unix_socket=...，它会忽略
port并强制走 socket；若只写
host=127.0.0.1，则一定走 TCP，此时
port才生效。很多“连不上”其实卡在默认行为上。
实操建议：
本地开发想走 TCP？DSN 必须用host=127.0.0.1，不能写
localhost线上容器环境常见
host=mysql（Docker service 名），需确认该 hostname 在 PHP 容器内能被 DNS 解析，可用
gethostbyname('mysql') 测试
port参数仅在 TCP 模式下起作用；若误加在 socket 连接 DSN 里，PDO 不报错但可能静默失效
PDO::ATTR_ERRMODE
设为 PDO::ERRMODE_EXCEPTION
之前就失败了怎么办
连接本身失败发生在 PDO 实例化阶段，早于任何属性设置。也就是说，
new PDO(...)抛异常时，
PDO::ATTR_ERRMODE还没机会生效——这不是配置问题，是构造函数参数或环境问题。
实操建议：
不要试图在try/catch外再包一层“设 errmode”，它对连接失败无影响 确认 PHP 已启用
pdo_mysql扩展：运行
php -m | grep pdo_mysql，缺扩展会直接 fatal error MySQL 服务是否真在运行？
systemctl is-active mysql或
mysqladmin ping -h127.0.0.1 -u... -p...直接验证
用户权限、SSL 和 SQL_MODE 导致的“连接成功但查询失败”
有时
new PDO()不报错，但后续
$pdo->query()立刻挂掉，错误如
SQLSTATE[HY000]: General error: 1045 Access denied...——这其实是 MySQL 在执行第一条语句时才校验具体权限或 SQL_MODE 兼容性。
实操建议：
检查用户是否被限制来源：SELECT host, user FROM mysql.user WHERE user='your_user';，确保 host 匹配连接来源 IP 或 % 若 MySQL 8.0+ 启用了
require_secure_transport=ON，而 PDO DSN 没配 SSL 参数，连接会被拒绝；加
&sslmode=required或显式传
['ssl_mode' => PDO::MYSQL_ATTR_SSL_MODE]某些旧应用依赖
NO_AUTO_CREATE_USER等已废弃 SQL_MODE，连接后立即执行
SET sql_mode='...'可临时绕过，但应尽快适配新模式
try {
$pdo = new PDO(
'mysql:host=127.0.0.1;port=3306;dbname=test;charset=utf8mb4',
'user',
'pass',
[
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]
);
} catch (PDOException $e) {
// 此处捕获的是连接级错误，不是 query 错误
error_log('PDO connect failed: ' . $e->getMessage());
throw $e;
}
MySQL 连接问题真正难的不是语法，是分清“是网络没通、认证被拒、权限不够，还是语句不兼容”。每种对应完全不同的排查路径，混在一起查只会反复验证错误的方向。 
