PDO连接失败应优先查看$e->getCode()和$e->getMessage()中的SQLSTATE与错误码：1045为认证失败，2002为socket路径错误，2003为网络不通；localhost默认走socket，需用127.0.0.1强制TCP；连接失败发生在实例化阶段，早于ATTR_ERRMODE设置。
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 连接问题真正难的不是语法，是分清“是网络没通、认证被拒、权限不够，还是语句不兼容”。每种对应完全不同的排查路径，混在一起查只会反复验证错误的方向。 
