解决 PHPMyAdmin 连接 MySQL ed25519 认证失败问题

理解问题：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 认证选项。

1. 编辑 MySQL 配置文件： 使用文本编辑器打开 MySQL 的主配置文件，通常位于 /etc/mysql/my.cnf 或 /etc/mysql/mysql.conf.d/mysqld.cnf。

   sudo nano /etc/mysql/my.cnf

   登录后复制

2. 添加或修改配置项： 在 [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 作为默认认证插件。

3. 重启 MySQL 服务： 保存配置文件后，必须重启 MySQL 服务以使更改生效。

   sudo systemctl restart mysql

   登录后复制

步骤二：更新数据库用户认证方法

即使服务器配置了默认认证插件，现有用户可能仍在使用 ed25519。因此，需要显式地将 PHPMyAdmin 将要连接的特定数据库用户的认证方法更改为 mysql_native_password。

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

22

查看详情

1. 登录 MySQL： 使用具有足够权限的用户（例如 root 用户）登录到 MySQL 命令行客户端。

   mysql -u root -p

   登录后复制

2. 修改用户认证插件： 执行以下 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免费学习笔记（深入）”；

以上就是解决 PHPMyAdmin 连接 MySQL ed25519 认证失败问题的详细内容，更多请关注php中文网其它相关文章！