MySQL: 解决 MySQL 错误："Authentication plugin 'caching_sha2_password' cannot be loaded"

本文档属于故障排除指南的一部分。您可以在此处查看完整指南：MySQL 常见问题及解决方案。

👋 欢迎查阅 Stackhero 文档！

Stackhero 提供全托管的 MySQL 云服务，简化了生产环境下的部署与管理：

• 无限制的连接数与数据传输。
• 集成的 phpMyAdmin Web 界面，便于数据库管理。
• 无忧的更新，一键升级。
• 在专属私有基础设施上实现持续高性能与强大安全性。

使用 Stackhero，您可以在几分钟内拥有可靠的 MySQL 数据库。让您将更多时间专注于应用开发，而不是环境搭建和维护。立即体验 Stackhero 的 MySQL 云主机服务。

MySQL 8 默认使用 caching_sha2_password 认证系统。当使用较旧的客户端库时，您可能会遇到错误："Authentication plugin 'caching_sha2_password' cannot be loaded"。要解决此问题，您可以将默认认证方法修改为使用 MySQL 本地密码。

在您的 Stackhero 仪表板中，导航到 MySQL 配置部分并选择 "MySQL native password" 作为认证插件。此设置会影响 root 用户和所有新创建的用户。

对于现有用户（不包括 root 用户），您可以使用 MySQL 命令行界面或 phpMyAdmin 执行以下命令：

USE mysql;
ALTER USER '<userToUpdate>'@'%' IDENTIFIED WITH mysql_native_password BY '<userPassword>';
FLUSH PRIVILEGES;