PDO连接失败主因是环境配置问题：pdo_mysql扩展未启用、host=localhost与127.0.0.1行为差异导致socket/TCP混淆、用户名密码漏引号被当常量、用户权限不匹配127.0.0.1、PHP版本切换后扩展需重配。
PHP 环境下 PDO 连接数据库报错，绝大多数不是代码写错了，而是环境没配好——pdo_mysql 扩展没装、没启、或根本没加载成功。
检查 pdo_mysql 扩展是否已启用
很多 PHP 环境（尤其是 phpEnv、XAMPP、WAMP）默认不启用 pdo_mysql，只开了 pdo 抽象层本身。光有 PDO 类，没有具体驱动，new PDO('mysql:...') 会直接抛出 PDOException: could not find driver。
- 运行
php -m | grep pdo，确认输出里有pdo_mysql（不是只有pdo） - 若无，打开 phpEnv 的 PHP 配置页（通常是
http://localhost/phpinfo.php），搜索pdo_mysql，看是否显示为“enabled” - 没启用就去 phpEnv 控制面板 → PHP 设置 → 扩展管理 → 勾选
pdo_mysql→ 重启 Apache/Nginx
DSN 中 host=127.0.0.1 和 host=localhost 行为不同
在 Windows 或某些 Linux 容器环境下，host=localhost 会让 MySQL 客户端走 socket 文件（Unix domain socket），而 host=127.0.0.1 强制走 TCP。如果 MySQL 配置禁用了 socket 或权限没开，localhost 就会静默失败，错误信息却只显示 Access denied，实际是连接根本没建立。
- 统一改用
host=127.0.0.1，避免歧义 - DSN 示例：
mysql:host=127.0.0.1;port=3306;dbname=testdb;charset=utf8mb4 - 确保 MySQL 用户权限允许从
127.0.0.1登录（不只是localhost）
用户名/密码被当成了未定义常量
这是新手高频翻车点：把变量或字符串字面量漏了引号，比如写成 new PDO($dsn, username, password)。PHP 会警告 Use of undefined constant username，然后自动当成字符串 'username' 传给 PDO，结果连的是用户 'username' 而不是你本意的值。
立即学习“PHP免费学习笔记（深入）”；
- 必须加引号：
new PDO($dsn, 'myuser', 'mypass')或用已定义变量：$user = 'myuser'; new PDO($dsn, $user, $pass) - 别用双引号包数组参数：
new PDO($dsn, $u, $p, "$options")→ 错！会触发Array to string conversion；应写成new PDO($dsn, $u, $p, $options) - 开启
error_reporting(E_ALL)，这类警告不会被忽略
连接后立即报 SQLSTATE[HY000] [1045] Access denied
这个错误看似是密码错，但真实原因常是：用户不存在、权限不足、或数据库名拼错导致认证流程提前中断。PDO 在连接阶段无法区分“用户不存在”和“密码错”，全归到 1045。
- 先用命令行验证凭据：
mysql -h 127.0.0.1 -u myuser -p testdb，能进说明 PHP 环境问题；进不去就回头查 MySQL 用户表 - 检查 MySQL 用户 host 字段：
SELECT user, host FROM mysql.user WHERE user = 'myuser';，确保有'myuser'@'127.0.0.1'或'myuser'@'%' - phpEnv 默认 MySQL root 密码常为空或
root，别默认填password
最常被忽略的一点：phpEnv 切换 PHP 版本后，扩展配置不会自动继承，每次切版本都得重新勾选 pdo_mysql 并重启服务——哪怕上一秒还连得好好的。
