Navicat连接MySQL失败主因是客户端不支持caching_sha2_password认证协议,需执行ALTER USER 'user'@'host' IDENTIFIED WITH mysql_native_password BY 'pwd'并FLUSH PRIVILEGES生效。

连不上不是密码错了,是客户端根本“听不懂”caching_sha2_password的握手协议——它要求 RSA 公钥交换或 TLS,而旧版 Navicat、PyMySQL、JDBC 5.1.x 等压根不支持。最直接有效的解法是改用户插件,不是调配置、不是升驱动(虽然那也得做),而是立刻让连接通起来。
怎么确认真是 caching_sha2_password 在报错
别猜,先登录 MySQL 命令行(比如用 mysql -u root -p),执行:
SELECT user, host, plugin FROM mysql.user WHERE user = 'your_user';
重点看三列:
-
user和host必须完全匹配你连接字符串里的值——'root'@'localhost'、'root'@'127.0.0.1'、'root'@'%'是三个独立账号 - 如果
plugin列值为caching_sha2_password,且你用的是以下任一情况,基本坐实问题:- Navicat 15 以下版本
- JDBC 驱动是
mysql-connector-java:5.1.x - PyMySQL mysqlclient
- PHP 7.3 及更早 + 未启用 mysqli 扩展
- 典型错误信息包括:
ERROR 2059 (HY000)、Authentication plugin 'caching_sha2_password' cannot be loaded、Unable to load authentication plugin
ALTER USER 切换插件必须带密码重写
这是唯一能立即生效、覆盖所有旧客户端的操作,但语法错一步就锁死账号:
- 必须写全
'user'@'host':Navicat 默认走 TCP 连接,'root'@'127.0.0.1'比'root'@'localhost'更常中招 - 语法必须是:
ALTER USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'MyPass123!';
漏掉BY 'xxx'会清空密码,账号立刻不可用 - 即使原密码没变,也必须显式重写一遍;只写
IDENTIFIED WITH mysql_native_password是无效操作 - 执行完必须紧跟:
FLUSH PRIVILEGES;,否则内存缓存不更新,新设置完全不生效 - 宝塔、phpEnv 等面板环境,
plugin字段在 phpMyAdmin 界面常为只读,必须进「SQL」标签页手动执行
为什么改 my.cnf 的 default_authentication_plugin 不起作用
这个配置项只影响「之后新建的用户」,对已存在的 root、应用账号、复制账号完全无效:
- 很多人改完
/etc/my.cnf就重启 MySQL,结果 Navicat 还是连不上——因为旧用户元数据根本没被碰过 -
--default-authentication-plugin=mysql_native_password这类启动参数,只作用于当前mysql客户端进程,对 Navicat、Java 应用、Python 脚本毫无影响 - 云数据库(如阿里云 RDS)通常禁止修改配置文件,这条路从一开始就不通;Docker/Podman 场景下加该参数也不修复存量用户
- 真正容易被忽略的是:Navicat 会缓存连接配置,改完服务端后不关软件重开、不删旧连接重建,它可能还在用旧握手参数重试
客户端驱动也要对齐(不能只靠服务端降级)
如果不想长期用 mysql_native_password,就得让客户端跟上:
- JDBC URL 必须加:
?allowPublicKeyRetrieval=true&useSSL=false(仅限内网可信环境),且驱动版本 ≥8.0.16 - PyMySQL ≥
1.0.2才原生支持caching_sha2_password;旧版要么升级,要么换mysql-connector-python - Node.js 的
mysql2需显式传参:authPlugin: 'caching_sha2_password',且版本 ≥2.0.0 - Docker 场景下,宿主机 MySQL 客户端版本 ≠ 容器内应用所用驱动版本,要分别检查
真正复杂的地方在于:同一个用户名在不同 host 下是独立账号,而工具默认连接方式(socket vs TCP)又决定了它实际匹配哪个;FLUSH PRIVILEGES 不执行就是白改,Navicat 不重启就是白配——这些细节比插件切换本身更常导致失败。











