PHP降级后数据库连不上，大概率是MySQL 8.0+默认认证插件caching_sha2_password不兼容老版本PHP所致；需将用户认证方式改为mysql_native_password，或检查扩展启用、连接参数及DSN编码。
PHP 降级后数据库连不上，大概率是 MySQL 8.0+ 默认认证插件不兼容导致的——老版本 PHP（如 7.4 或更早）压根不认识 caching_sha2_password，连接时静默失败或报 Authentication plugin 'caching_sha2_password' cannot be loaded。
为什么降级 PHP 后突然连不上？
MySQL 8.0 起将默认身份验证插件从 mysql_native_password 改为 caching_sha2_password。PHP 8.0+ 原生支持该插件，但 PHP 7.4 及更早版本的 mysqli 和 PDO_mysql 扩展未内置兼容逻辑。降级后，即使账号密码完全正确，握手阶段就会被拒绝。
- 典型错误现象：
PDOException报错含caching_sha2_password关键词，或mysqli_connect()返回空、页面白屏无提示 - 不是配置错了，也不是服务停了——命令行
mysql -u user -p能正常登录，但 PHP 就是连不上 - 尤其高发于本地开发环境（如 MAMP、XAMPP 降级 PHP）或 Docker 中固定使用旧版 PHP 镜像的场景
直接改 MySQL 用户认证方式（推荐）
这是最稳妥、无需动代码的解法。登录 MySQL（用 root 或有 GRANT 权限的账号），执行：
ALTER USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES;
- 把
'your_user'换成你 PHP 中实际使用的用户名，'localhost'换成对应 Host（如'%'或具体 IP） - 如果用户是远程连接（比如云数据库），Host 得匹配，例如
'your_user'@'192.168.1.100' - 执行完立刻生效，PHP 不需重启，下次连接自动走旧认证协议
- 注意：不要对 root 用户贸然操作，除非你有备用管理通道
检查 PDO / mysqli 扩展是否真启用
PHP 降级常伴随扩展重装或路径变更，容易漏掉驱动模块：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -m | grep -i pdo和php -m | grep -i mysql，确认输出含pdo、pdo_mysql、mysqli - 若缺失，在 Ubuntu/Debian 上装：
sudo apt install php-mysql；CentOS/RHEL：sudo yum install php-mysqlnd - Docker Alpine 镜像要额外注意：PHP 版本号必须严格匹配扩展包名，例如
apk add php81-pdo_mysql（不是php8-pdo_mysql） - 改完 php.ini 后，务必重启 Web 服务（
sudo systemctl restart apache2或sudo systemctl restart php-fpm）
别忽略连接参数里的隐性陷阱
降级常发生在调试环境，而这类环境容易混用 localhost / 127.0.0.1、Unix socket / TCP，引发二次失败：
- PHP 连接字符串里写
host=localhost，MySQL 却只监听 TCP（skip-networking=OFF且bind-address=127.0.0.1），此时会 fallback 到 Unix socket，但 socket 路径可能和旧版 PHP 编译时指定的不一致 → 报错No such file or directory - 解法：统一强制走 TCP，把
host改成127.0.0.1，并显式加port=3306 - ThinkPHP/Laravel 等框架若用
.env，确认DB_HOST=127.0.0.1（不是localhsot这类拼写错误） - 密码含特殊字符（如
@、/）时，PDO DSN 必须 URL 编码，否则解析中断——降级环境更易暴露这类低级错误
真正麻烦的不是认证插件本身，而是它常和扩展缺失、host 解析错位、DSN 编码问题叠在一起出现。先用命令行 mysql -h 127.0.0.1 -P 3306 -u user -p 确认底层通不通，再开 ini_set('display_errors', 1) 把真实报错打出来，比瞎猜快十倍。
