MySQL 升级后认证插件故障排查

在使用 Arch Linux 进行日常滚动升级(pacman -Syu)或在生产环境中将 MySQL 升级至 8.4 LTS 或 9.0+ Innovation 版本后,很多基于 PHP(WordPress/Laravel)、旧版 Node.js、Python 或旧版 Navicat 的业务服务突然发生大面积连接崩溃,服务端日志赫然抛出以下经典致命异常:

1
2
SQLSTATE[HY000] [1524] Plugin 'mysql_native_password' is not loaded
mysqli_sql_exception: Plugin 'mysql_native_password' is not loaded.

为什么升级前运行良好的数据库,在版本号一跃之后连认证插件都找不到了?

本文将还原此次事故的底层演化逻辑,提供立即可用的救急方案(临时开启旧插件)与面向未来的正道方案(升级客户端驱动与无缝平移到 caching_sha2_password),并拆解跨版本认证加密的演进脉络。


一、事故根因:MySQL 官方认证体系的历史大迁徙

要理解为什么会报 Plugin 'mysql_native_password' is not loaded,我们先来看一张 MySQL 默认身份验证插件的版本演进时间线:

1
2
3
4
5
6
7
8
9
10
11
12
MySQL 5.7 及更早
└─► 默认: mysql_native_password (基于 SHA-1 哈希,极易被彩虹表/现代 GPU 暴力破解)
│
MySQL 8.0 (2018)
└─► 默认切换为: caching_sha2_password (基于加盐 SHA-256 + 内存缓存高速校验)
└─► 兼容保留: mysql_native_password (内置启用,老客户端仍可无感握手)
│
MySQL 8.4 LTS (2024.04 发布) ───►【首发重雷区】
└─► 默认彻底关闭: mysql_native_password (不再默认加载,必须显式配置开启)
│
MySQL 9.0+ Innovation (2024.07 发布)
└─► 全面废弃与彻底移除: mysql_native_password 插件代码被官方彻底清扫下线!

1. 为什么 Arch Linux 用户最先踩雷?

Arch Linux 采用的是最激进的 滚动发行模式(Rolling Release)。当上游 MySQL 发布 8.4 LTS 或 9.0 新版时,Arch 的软件仓库会在几天内甚至几小时内同步推送最新二进制。执行 pacman -Syu 后,服务器直接被一脚踹入了新世界。

2. 为什么会抛出 1524 错误?

升级后,服务端的 MySQL 已经不再默认装载 mysql_native_password 动态链接库。但你在数据库老表 mysql.user 中为应用创建的用户,其 plugin 字段依旧记录着历史旧值:

1
2
3
4
5
6
7
8
9
SELECT user, host, plugin FROM mysql.user;

-- 输出:
-- +--------+-----------+-----------------------+
-- | user | host | plugin |
-- +--------+-----------+-----------------------+
-- | root | localhost | mysql_native_password | <-- 仍然要求使用旧插件!
-- | webapp | % | mysql_native_password |
-- +--------+-----------+-----------------------+

当客户端(如 PHP mysqli、老版 mysql 驱动)发起 TCP 连接握手时,MySQL 服务端在内存中找了一圈,发现根本没有加载名为 mysql_native_password 的认证插件,便毫不客气地丢出了 1524 Plugin 'mysql_native_password' is not loaded 阻断连接!


二、方案一:火速救急——在配置中强制重新装载旧插件

如果线上业务众多、调用方驱动老旧无法立即改动发版,最快的止血手段是在 MySQL 服务端显式开机加载 mysql_native_password 插件。

⚠️ 版本注意:该临时方案在 MySQL 8.4 LTS 中完全有效;但在 MySQL 9.0+ 中已被彻底移除,只能走方案二进行账号升级。

1. 修改 MySQL 配置文件

编辑你的 MySQL 配置文件(根据系统不同,位于 /etc/my.cnf、/etc/mysql/my.cnf 或 /etc/my.cnf.d/server.cnf):

在 [mysqld] 配置段下追加以下参数:

1
2
3
[mysqld]
# 显式启用历史上遗留的 mysql_native_password 认证插件
mysql_native_password=ON

2. 重启 MySQL 服务并验证

在 Linux / systemd 下重启服务:

1
2
3
sudo systemctl restart mysqld
# 或者如果是 mariadb
# sudo systemctl restart mariadb

登录 MySQL 命令行验证插件是否已成功装载:

1
2
3
4
5
6
7
-- 检查已加载的认证插件列表
SHOW PLUGINS;

-- 查看 mysql_native_password 插件状态
SELECT PLUGIN_NAME, PLUGIN_STATUS, PLUGIN_TYPE
FROM INFORMATION_SCHEMA.PLUGINS
WHERE PLUGIN_NAME LIKE '%password%';

当看到 mysql_native_password 处于 ACTIVE 状态时,之前报错的应用程序即可立即恢复正常访问。


三、方案二:面向未来的长效正解——全面升级至 caching_sha2_password

重新打开旧插件只是技术负债的延期。mysql_native_password 基于 1995 年代落后的单轮 SHA-1 散列算法,在现代算力下已被证实极易遭受彩虹表碰撞。官方在 MySQL 9.x 中已经彻底清空该插件,未来升级依然必死无疑。

最规范的做法是将数据库用户无缝升级为现代业界标准的 caching_sha2_password,并升级客户端驱动。

1. 修改数据库账号认证插件

以 root 用户登录 MySQL 终端,执行以下 SQL 命令:

1
2
3
4
5
6
7
8
9
10
11
-- 1. 将指定账号的认证插件平滑切换为现代标准的 caching_sha2_password
ALTER USER 'webapp'@'%' IDENTIFIED WITH caching_sha2_password BY 'YourStrongPassword123!';

-- 如果是本地 root 账号
ALTER USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'YourRootPassword123!';

-- 2. 刷新系统权限字典缓存,立即生效
FLUSH PRIVILEGES;

-- 3. 检查确认 plugin 字段是否已更新
SELECT user, host, plugin FROM mysql.user WHERE user IN ('root', 'webapp');

执行后,用户元数据中的 plugin 字段将更新为 caching_sha2_password。

2. 客户端驱动适配与升级清单

把数据库用户改成 caching_sha2_password 后,各语言的客户端驱动需要确保符合如下最低版本要求:

① PHP 生态

  • 核心依赖:确保 PHP 安装并启用了 mysqlnd(MySQL Native Driver) 扩展,而非古早的 libmysqlclient;
  • PHP 版本:PHP 7.4+、PHP 8.0+ 的 pdo_mysql 和 mysqli 在搭配 mysqlnd 时天然支持 caching_sha2_password。

② Node.js 生态

  • 避免使用已停止维护的 mysql 库(npm install mysql 默认包早已不维护且不支持现代密码学握手);
  • 无缝迁移至 mysql2:
    1
    2
    npm uninstall mysql
    npm install mysql2
    mysql2 API 与老版完全兼容,但内置了完整的 RSA 公钥置换与 caching_sha2_password 驱动。

③ 数据库客户端工具(Navicat / DBeaver / DataGrip)

  • Navicat:Navicat 11 及更早版本不支持 caching_sha2_password,会报 2059 - Authentication plugin 'caching_sha2_password' cannot be loaded,建议升级至 Navicat 15+ 或改用跨平台开源的 DBeaver、TablePlus。

四、升级后的经典连带暗坑:Public Key Retrieval is not allowed

当把用户迁移为 caching_sha2_password 后,很多 Java / Node.js 开发者在没有配置 SSL/TLS 证书的纯内网连接时,会紧接着撞上第二个常见报错:

1
2
3
java.sql.SQLNonTransientConnectionException: Public Key Retrieval is not allowed
或
Error: ER_AUTH_PLUGIN_CANNOT_LOAD: Public Key Retrieval is not allowed

为什么会出现这个错误?

caching_sha2_password 为了防止密码哈希在网络明文传输中被嗅探,规定:

  • 如果连接开启了 SSL/TLS 加密,直接通过 TLS 隧道安全传输明文密码;
  • 如果连接未启用 SSL,客户端必须向服务端索要公钥(RSA Public Key),用服务端的公钥把密码加密后再发往服务端。
  • 出于安全防中间人(MITM)考虑,客户端驱动默认禁止向未受信任的未知服务端随意索要公钥!

优雅排错方案:

方案 A:在客户端连接串中显式允许检索公钥(最常见)

  • JDBC 连接串:
    1
    jdbc:mysql://localhost:3306/mydb?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=UTC
  • Node.js (mysql2):
    1
    2
    3
    4
    5
    6
    7
    8
    const connection = mysql.createConnection({
    host: 'localhost',
    user: 'webapp',
    password: 'password',
    database: 'mydb',
    ssl: false,
    allowPublicKeyRetrieval: true // 允许非 SSL 连接下从服务器拉取公钥加密
    });

方案 B:在连接中提供本地公钥文件(最高安全等级)

在连接配置中指定服务端的 public_key.pem 路径,客户端直接使用本地固化的公钥加密密码,杜绝网络嗅探。


五、总结与迁移决策树

面对 MySQL 升级引发的 1524 认证插件断裂,可遵循以下决策树处置:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
                    [遭遇 1524 认证插件缺失报错]
│
你的 MySQL 是 9.0+ 还是 8.4 LTS?
│
┌───────────────────┴───────────────────┐
▼ ▼
【MySQL 8.4 LTS】 【MySQL 9.0+】
│ │
能否短时间内修改各端代码? (插件源码已被官方彻底删除)
│ │
┌───────┴───────┐ │
▼ (否, 紧急救火) ▼ (是, 彻底重构) │
在 my.cnf 开启: 将账号迁移至: │
mysql_native_ caching_sha2_password │
password=ON + 升级客户端驱动 │
│ ▲ │
└───────────────────────┴───────────────────────┘

技术设施的演进总是在安全性与向前兼容性之间博弈。拥抱现代的 caching_sha2_password,既是顺应数据库架构标准的必然趋势,也是守护线上数据安全的第一道坚实防线。


MySQL 升级后认证插件故障排查
https://bubao.github.io/posts/34c89562.html
作者
一念
发布于
2024年7月17日
许可协议