PDO类未找到说明pdo_mysql扩展未启用，需在宝塔中勾选安装并重启PHP服务，同时确认mysqlnd驱动已启用、socket路径正确，并将DSN中的localhost替换为127.0.0.1以避免DNS解析问题。
pdo_mysql 扩展没启用，new PDO() 直接报 Class 'PDO' not found
PHP 8.0 安装完，php -m 里看不到 pdo_mysql，或者 Laravel/ThinkPHP 启动就崩在 Class 'PDO'，说明扩展根本没加载。宝塔默认不自动启用这个模块，哪怕你勾选了“安装扩展”，也只下载不启用。
检查方法：php -m | grep pdo —— 如果只输出 pdo（基础驱动），没 pdo_mysql，就是它没开。
- 进宝塔 → 软件商店 → 找到你装的 PHP 8.0 → 点“设置” → 切到“安装扩展”页
- 确认
pdo_mysql左侧复选框是 ✅ 状态；如果灰色或没勾，手动勾上再点“安装” - 别信“已安装”提示——有些版本勾了也不生效，必须点一次“安装”触发启用逻辑
- 改完必须点“重启”PHP，不是“重载配置”；
service php-fpm-80 restart也行
扩展启用了但 PDO::ATTR_ERRMODE 报错，其实是 mysqlnd 驱动缺失
扩展显示已启用，new PDO('mysql:host=localhost;dbname=test') 却抛 SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client，这不是密码错，是 PHP 8.0 缺少 mysqlnd（MySQL native driver）支持。
宝塔 PHP 8.0 默认编译时可能没带 mysqlnd，导致 PDO 底层用不了新认证方式（如 caching_sha2_password）。
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -i | grep "mysqlnd"，没输出就证实缺失 - 解决办法：重装 PHP 8.0，在宝塔“软件商店”里点该 PHP 版本右上角“设置” → “编译安装” → 勾选
mysqlnd（别漏掉） - 或临时降级认证方式：MySQL 里执行
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass'; FLUSH PRIVILEGES;
pdo_mysql.default_socket 指向错误，本地连接走 socket 失败
用 localhost 连 MySQL 时，PDO 默认走 Unix socket，而不是 TCP。但宝塔 MySQL 的 socket 文件实际在 /www/server/data/mysql.sock，而 PHP 8.0 可能还读着旧路径 /tmp/mysql.sock，结果报 Can't connect to local MySQL server through socket。
- 查 MySQL 实际 socket：
mysql -u root -p -e "SHOW VARIABLES LIKE 'socket';" - 进宝塔 → PHP 8.0 设置 → 配置文件，在末尾加两行：
pdo_mysql.default_socket = /www/server/data/mysql.sock<br>mysqli.default_socket = /www/server/data/mysql.sock
- 保存后必须“重启”PHP，重载不生效；
php --ini确认加载的是你刚改的php.ini
连接时卡住几秒才报错，大概率是 DNS 解析拖慢了 localhost
PHP 8.0 的 PDO 对 localhost 有特殊处理：它会先尝试 socket，失败后自动 fallback 到 127.0.0.1，但中间可能触发 DNS 查询（尤其服务器 hosts 配置异常时），导致延迟明显。
- 最稳写法：把 DSN 里的
host=localhost改成host=127.0.0.1 - 避免歧义，也绕过 socket 路径问题：
mysql:host=127.0.0.1;port=3306;dbname=test - 如果真要用 socket，显式指定：
mysql:unix_socket=/www/server/data/mysql.sock;dbname=test
真正容易被忽略的是：PHP 8.0 的 pdo_mysql 和 mysqlnd 是两个独立开关，一个开了不代表另一个自动有；且 socket 路径错一次，所有用 localhost 的连接都会静默失败，日志里还不报具体路径——得靠 strace 或看 MySQL 错误日志才能定位。
