PHP 8.5 连 MySQL 8.0 报 PDOException: SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client
这是最常见、最典型的连接失败——MySQL 8.0 默认用 caching_sha2_password 认证插件，而 PHP 8.5（哪怕带最新 PDO MySQL 扩展）默认不支持它，除非底层 OpenSSL 和 mysqlnd 编译时启用了 SHA-2 支持，且 PHP 版本足够新（实际多数生产环境的 PHP 8.5 构建并未启用）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 优先改 MySQL 用户认证方式：执行
ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass'; FLUSH PRIVILEGES; - 不要只改
root，你应用用的数据库用户必须单独改；%要和你连接时用的 host 一致（比如是127.0.0.1就得用'user'@'127.0.0.1'） - 改完立刻测试：用命令行
mysql -u your_user -p -h 127.0.0.1能登进去，PDO 才大概率能连上 - 如果必须保留
caching_sha2_password（比如云数据库不允许改认证方式），就得确认 PHP 是用 mysqlnd 编译、且启用了--with-openssl，否则硬连会直接报错，不是配置问题，是扩展缺失
pdo_mysql 扩展没启用或版本不匹配
PHP 8.5 自带 pdo 扩展，但 pdo_mysql 是独立扩展，默认不自动加载。即使开了，旧版（如 PHP 7.x 编译的）可能不兼容 MySQL 8.0 的协议细节（比如新字段类型 JSON、TINYINT(1) 布尔映射）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -m | grep pdo确认输出含pdo_mysql；没有就编辑php.ini，取消注释extension=pdo_mysql（Windows 下是php_pdo_mysql.dll） - 检查
php --ri pdo_mysql输出里的Client API version，应为8.0.x或更高；若显示5.7.x，说明你装的是旧版 mysqlnd，需重装 PHP 或用包管理器升级（如 Ubuntu 的apt install php8.5-mysql） - 别信“PHP 8.5 自带兼容”，
pdo_mysql的客户端库版本取决于编译时链接的 mysqlnd，不是 PHP 主版本号
DNS 解析或 socket 路径导致连接超时/拒绝
MySQL 8.0 默认绑定 127.0.0.1（IPv4），禁用 localhost 的 Unix socket；而 PHP 的 PDO 默认用 localhost，在 Linux 上会尝试走 socket 文件，结果连不上。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 连接 DSN 写死 IPv4：
mysql:host=127.0.0.1;dbname=test，别用localhost - 查 MySQL 配置：
SELECT @@bind_address, @@skip_networking;，确保不是127.0.0.1以外的地址，且skip_networking是OFF - 如果真要用 socket（比如性能敏感场景），DSN 改成
mysql:unix_socket=/var/run/mysqld/mysqld.sock;dbname=test，路径以mysql --socket输出为准 - 防火墙、SELinux、Docker 网络隔离都可能拦截
3306，先用telnet 127.0.0.1 3306或nc -zv 127.0.0.1 3306排查底层连通性
charset 和严格模式引发的隐式错误
MySQL 8.0 默认开启 STRICT_TRANS_TABLES，且字符集强制用 utf8mb4；PDO 若没显式设 charset，可能触发插入超长字符串被截断、emoji 插入失败、甚至 INSERT 直接报错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- DSN 加
;charset=utf8mb4：完整写法是mysql:host=127.0.0.1;dbname=test;charset=utf8mb4 - 创建 PDO 实例时，用
options显式设置：new PDO($dsn, $user, $pass, [PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"]) - 别依赖
SET NAMES，MySQL 8.0 对utf8别名已警告弃用，必须用utf8mb4 - 检查表结构：如果字段是
VARCHAR(255)但用utf8mb4，实际最大字节数是 1020，超长插入会失败；PDO 不报错，但$pdo->lastInsertId()可能返回 0，需主动查$pdo->errorInfo()
真正卡住人的往往不是“连不上”，而是连上了却在某次 INSERT 或 JOIN 时突然崩——这时候回头看认证方式、字符集、SQL 模式，八成是其中一项没对齐。MySQL 8.0 和 PHP 8.5 都更“较真”了，容错空间比以前小得多。
