MySQL 8.4中mysql_native_password插件弃用问题解决方案

MySQL 8.4版本发布后，许多开发者在升级数据库环境时遇到了一个新的兼容性问题：mysql_native_password认证插件被标记为弃用（Deprecated）。部分应用程序在连接数据库时出现认证失败、用户无法登录或者驱动兼容异常等问题。

这一变化并不是简单地删除旧插件，而是MySQL官方对数据库安全认证机制的一次升级。了解mysql_native_password弃用原因，并掌握正确迁移方式，对于保证线上系统稳定运行非常重要。

一、mysql_native_password插件为什么被弃用

mysql_native_password是MySQL长期以来默认使用的一种身份认证插件，它基于传统密码散列机制完成用户身份验证。

在MySQL 5.x和MySQL 8.0早期版本中，大量应用依赖该认证方式，例如：

• Java应用使用旧版本JDBC驱动连接MySQL；

• PHP项目通过旧版MySQL扩展访问数据库；

• 运维脚本依赖传统认证方式；

• 第三方工具只支持旧认证协议。

随着安全需求提升，MySQL官方推出了更加安全的认证插件：

caching_sha2_password

该插件采用更强的SHA-256算法，并支持缓存认证结果，提高安全性的同时降低重复认证开销。

从MySQL 8.0开始，caching_sha2_password已经成为默认认证插件。而到了MySQL 8.4版本，mysql_native_password进一步被标记为弃用，意味着未来版本可能彻底移除支持。

二、升级MySQL 8.4后常见报错

升级数据库版本后，常见的问题主要包括以下几类。

1. 用户认证失败

连接数据库时出现：

ERROR 1524 (HY000): Plugin 'mysql_native_password' is not loaded

通常表示当前MySQL实例没有加载该认证插件，但用户账号仍然指定使用：

mysql_native_password

可以通过查询用户认证方式确认：

SELECT user, host, plugin 
FROM mysql.user;

如果结果类似：

root    localhost    mysql_native_password
app     %            mysql_native_password

说明账号仍依赖旧认证插件。

2. 应用连接异常

例如Java项目启动时报：

Public Key Retrieval is not allowed

或者：

Authentication plugin 'caching_sha2_password' cannot be loaded

这通常不是MySQL服务异常，而是客户端驱动版本过低导致。

MySQL 8.4默认认证方式发生变化，如果客户端仍使用旧版驱动，就可能无法完成认证流程。

三、推荐解决方案：迁移到caching_sha2_password

对于新项目或者可以升级客户端的系统，推荐直接切换到MySQL默认认证方式：

caching_sha2_password

1. 修改已有用户认证插件

执行：

ALTER USER '用户名'@'主机'
IDENTIFIED WITH caching_sha2_password
BY '新密码';

例如：

ALTER USER 'app_user'@'%'
IDENTIFIED WITH caching_sha2_password
BY '123456';

修改完成后刷新权限：

FLUSH PRIVILEGES;

再次查看：

SELECT user,host,plugin 
FROM mysql.user;

确认插件已经变更。

2. 创建新用户时指定认证方式

创建用户：

CREATE USER 'test_user'@'%'
IDENTIFIED WITH caching_sha2_password
BY 'password';

授权：

GRANT ALL PRIVILEGES 
ON database_name.*
TO 'test_user'@'%';

这种方式更符合MySQL 8.4推荐实践。

四、旧系统必须继续使用mysql_native_password怎么办

虽然MySQL 8.4中该插件被弃用，但部分老项目暂时无法升级，例如：

• 老版本Java应用；

• 历史PHP系统；

• 停止维护的第三方软件；

• 企业内部旧管理系统。

这种情况下，可以临时启用兼容模式。

方法一：启动时加载插件

修改MySQL配置文件：

Linux环境：

vim /etc/my.cnf

增加：

[mysqld]
mysql_native_password=ON

然后重启MySQL：

systemctl restart mysqld

Windows环境修改：

my.ini

加入相同配置。

方法二：使用命令行参数启动

启动MySQL服务时：

mysqld --mysql-native-password=ON

启用旧认证插件。

需要注意的是，该方式只是临时兼容方案，不建议长期依赖。

五、升级客户端驱动解决兼容问题

很多认证问题并不是数据库配置造成，而是客户端驱动版本过旧。

Java项目

如果使用MySQL Connector/J：

旧版本：

mysql-connector-java 5.x

建议升级：

mysql-connector-j 8.x

Maven配置示例：

    com.mysql
    mysql-connector-j
    8.4.0

新版驱动已经完整支持：

• caching_sha2_password；

• MySQL 8.x认证协议；

• SSL安全连接。

PHP项目

如果仍使用旧版PHP扩展：

mysql_connect()

建议迁移到：

• mysqli；

• PDO_MySQL。

同时升级PHP版本，使其支持MySQL 8.4认证机制。

六、批量检查数据库用户认证方式

生产环境升级前，可以先检查所有用户：

SELECT 
    user,
    host,
    plugin
FROM mysql.user;

重点关注：

mysql_native_password

用户。

如果数量较多，可以生成迁移语句：

SELECT CONCAT(
"ALTER USER '",
user,
"'@'",
host,
"' IDENTIFIED WITH caching_sha2_password BY '重新设置密码';"
)
FROM mysql.user
WHERE plugin='mysql_native_password';

执行前建议：

1. 备份用户权限；

2. 测试业务连接；

3. 在测试环境验证；

4. 再迁移生产环境。

七、升级MySQL 8.4时的最佳实践

为了避免认证插件导致业务中断，可以按照以下流程操作。

第一步：升级客户端

优先升级：

• 数据库驱动；

• ORM框架；

• 数据访问组件。

例如：

• MyBatis；

• Hibernate；

• Spring Data JPA。

第二步：检查用户认证插件

执行：

SELECT user,host,plugin