理解问题：PHPMyAdmin 与 ed25519 认证的冲突
当 mysql 服务器配置为使用 ed25519 认证插件对用户进行身份验证时，phpmyadmin 可能会因为其底层 php mysqli 驱动不支持该认证方法而导致连接失败。用户会遇到类似以下错误信息：mysqli::real_connect(): the server requested authentication method unknown to the client [client_ed25519] 或 (hy000/2054): the server requested authentication method unknown to the client。这表明 phpmyadmin 无法识别或处理服务器请求的 ed25519 认证机制。
解决方案核心：回退到 mysql_native_password
为了解决此兼容性问题，最直接的方法是配置 MySQL 服务器，使其默认使用 PHPMyAdmin 及其底层驱动所支持的 mysql_native_password 认证方法，并针对特定用户更新其认证方式。这涉及到对 MySQL 配置文件和用户权限的修改。
步骤一：配置 MySQL 服务器默认认证插件
首先，需要修改 MySQL 服务器的配置文件 (my.cnf 或 mysql.cnf)，以确保服务器在必要时能够提供 mysql_native_password 认证选项。
-
编辑 MySQL 配置文件： 使用文本编辑器打开 MySQL 的主配置文件，通常位于 /etc/mysql/my.cnf 或 /etc/mysql/mysql.conf.d/mysqld.cnf。
sudo nano /etc/mysql/my.cnf
-
添加或修改配置项： 在 [client]、[mysql] 和 [mysqld] 部分添加或修改以下配置行。特别重要的是在 [mysqld] 部分设置 default-authentication-plugin=mysql_native_password。
[client] default-character-set=utf8 [mysql] default-character-set=utf8 [mysqld] collation-server = utf8_unicode_ci character-set-server = utf8 default-authentication-plugin=mysql_native_password
- default-character-set=utf8：确保客户端和服务器之间的字符集一致性，避免乱码问题。
- collation-server = utf8_unicode_ci 和 character-set-server = utf8：设置服务器的默认字符集和排序规则。
- default-authentication-plugin=mysql_native_password：这是关键配置，它指示 MySQL 服务器在没有明确指定时，优先使用 mysql_native_password 作为默认认证插件。
-
重启 MySQL 服务： 保存配置文件后，必须重启 MySQL 服务以使更改生效。
sudo systemctl restart mysql
步骤二：更新数据库用户认证方法
即使服务器配置了默认认证插件，现有用户可能仍在使用 ed25519。因此，需要显式地将 PHPMyAdmin 将要连接的特定数据库用户的认证方法更改为 mysql_native_password。
-
登录 MySQL： 使用具有足够权限的用户（例如 root 用户）登录到 MySQL 命令行客户端。
mysql -u root -p
-
修改用户认证插件： 执行以下 SQL 命令，将目标用户的认证插件更改为 mysql_native_password，并设置其密码。
ALTER USER 'username'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_new_password'; FLUSH PRIVILEGES;
- 请务必将 'username' 替换为实际的数据库用户名。
- 将 'localhost' 替换为用户的主机名（例如，如果用户从任何地方连接，可以是 '%'）。
- 将 'your_new_password' 替换为您为该用户设置的实际密码。
- FLUSH PRIVILEGES; 命令用于重新加载授权表，确保更改立即生效。
注意事项与最佳实践
- 安全性考量： ed25519 是一种更现代、更安全的认证方法。将认证方法回退到 mysql_native_password 可能会在一定程度上降低安全性。在生产环境中，应权衡兼容性与安全性，并考虑是否有更新 PHP 或其 MySQLi 驱动以支持 ed25519 的可能性。
- 用户权限： 确保您用于执行 ALTER USER 命令的 MySQL 用户具有修改其他用户权限的权限。
- 密码管理： 在 ALTER USER 命令中设置的密码应是强密码，并且应妥善保管。
- 测试连接： 完成上述步骤后，尝试通过 PHPMyAdmin 连接到 MySQL 数据库，验证问题是否已解决。如果仍然遇到问题，请检查 MySQL 错误日志以获取更多详细信息。
总结
通过以上两步操作——修改 MySQL 服务器配置文件以设置默认认证插件，并更新特定数据库用户的认证方法——可以有效解决 PHPMyAdmin 因不支持 ed25519 认证插件而导致的连接失败问题。此方法确保了 PHPMyAdmin 能够使用兼容的 mysql_native_password 认证方式与 MySQL 数据库进行通信。
立即学习“PHP免费学习笔记（深入）”；
