PDO连接失败应按顺序排查：检查CLI与Web环境的扩展启用状态、验证DSN参数（主机用127.0.0.1而非localhost、端口显式指定、密码URL编码）、开启PDO异常模式捕获错误码、确认MySQL服务运行及用户权限配置。
PHP PDO 连接失败时，别急着重装扩展或改配置，90% 的问题出在几个关键点上。先看错误信息，再按顺序排查，效率高很多。
检查 PDO 扩展是否真正启用
phpinfo() 显示 pdo_mysql 已加载 ≠ 实际可用。常见情况是 CLI 和 Web 使用不同 php.ini：
- 终端执行 php -m | grep pdo 确认 CLI 环境已启用
- 在 Web 脚本中写 phpinfo()，搜索 “Loaded Configuration File”，确认实际加载的 ini 文件路径
- 检查该 ini 文件里是否有 extension=pdo.so 和 extension=pdo_mysql.so（Linux/macOS）或 php_pdo.dll、php_pdo_mysql.dll（Windows）
- 重启对应服务（如 Apache 或 php-fpm），不是只改了 ini 就生效
验证连接参数是否准确无误
用户名、密码、主机、端口、数据库名看似简单，但大小写、空格、特殊字符、端口默认值最容易出错：
- MySQL 默认端口是 3306，如果用 Docker 或云数据库，可能映射到其他端口（如 3307），必须显式指定
- 主机名别写 localhost —— 它会触发 Unix socket 连接，而 root 用户常被限制仅允许 socket 登录；换成 127.0.0.1 强制走 TCP
- 密码含 $、@、/ 等字符？需用 urlencode() 编码后拼入 DSN，例如：password=abc%40123
- 数据库名不存在或拼错？PDO 不会自动创建库，连接前需确保库已存在且用户有权限
捕获并解读真实错误信息
PDO 默认静默失败，必须主动开启异常模式才能看到具体原因：
立即学习“PHP免费学习笔记（深入）”；
- 创建 PDO 实例时传入选项：new PDO($dsn, $user, $pass, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION])
- 不要只 catch Exception，建议同时捕获 PDOException 并打印 $e->getMessage() 和 $e->getCode()
- 典型错误码含义：HY000 多为认证/网络问题；2002 表示连接被拒绝（端口不通、服务未启）；1045 是用户名或密码错误；1049 是数据库不存在
检查 MySQL 服务与权限配置
即使 PHP 和 DSN 都对，MySQL 层也可能拦住连接：
- 运行 mysql -h 127.0.0.1 -u your_user -p 测试能否从命令行连上，排除网络和账号问题
- 登录 MySQL 后执行：SELECT host, user FROM mysql.user; 确认该用户允许从你连接的 host（如 % 或 127.0.0.1）登录
- 执行 SHOW GRANTS FOR 'your_user'@'%'; 检查是否有 USAGE 权限（最基础连接权），以及目标数据库的 SELECT/INSERT 等权限
- 云数据库（如阿里云 RDS、腾讯云 CDB）需额外检查安全组规则、白名单 IP 和 SSL 要求
