最快最稳的解法是直接修改服务端用户认证插件为mysql_native_password。需先查mysql.user表确认问题用户的plugin和host,再用alter user命令切换认证方式,注意单引号和密码一致性,云环境勿改my.cnf。

直接改服务端用户认证插件,别升级客户端——这是最快、最稳的解法。 错误本质是 MySQL 8.0 默认用 caching_sha2_password,而 Navicat 旧版、Node.js 的 mysql 包、PyMySQL 等压根不认这个协议。升级客户端只是绕路,改 ALTER USER 才是正解。
查当前用户的 plugin 是不是 caching_sha2_password
用能连上的方式(比如本地命令行)登录 MySQL,执行:
SELECT host, user, plugin FROM mysql.user WHERE user = 'your_username';
重点看三件事:
-
plugin值是不是caching_sha2_password—— 是就坐实问题 -
host是'localhost'还是'%'—— 不同 host 可能配了不同插件,必须对得上你连接时用的 host - 别只查
root,查你应用实际连的那个用户名(比如'app_user')
用 ALTER USER 切回 mysql_native_password
对出问题的用户执行一条命令即可,例如:
在 Arc Network 上使用 Credex 协议为 AI 代理提供无担保信贷。可凭声誉借 USDC、偿还债务提升额度、提供流动性或通过 Circle Bridge 跨链管理 USDC。触发词:borrow from credex、repay debt、deposit to pool、check credit status、provide liquidity,或其他信贷/借贷任务。
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
注意这几点:
- 用户名和 host 必须加单引号,写成
'root'@'localhost',漏掉或写成root@localhost会报语法错 - 密码明文写在语句里,确保和你要用的连接密码一致
- 远程连接(比如 Navicat 连云服务器)通常用的是
'root'@'%',别硬套 localhost - 执行完立刻生效,但保险起见补一句
FLUSH PRIVILEGES;
云数据库或 Docker 环境下别碰 my.cnf
有些教程让你改 my.cnf 加 default_authentication_plugin=mysql_native_password,再重启 MySQL —— 这招在阿里云 RDS、腾讯云 CDB 或多数 MySQL Docker 镜像里根本无效。
原因很实在:
- 云数据库通常禁用全局配置修改权限
- 即使改了,也只影响之后新建的用户,已有用户 plugin 不变,还得单独
ALTER USER - 生产环境开全局降级,等于放弃
caching_sha2_password带来的传输加密增强和密码缓存优化
真正卡住人的,从来不是命令敲不对,而是查 mysql.user 时没盯住 host 字段的具体值、ALTER USER 时漏了单引号、或者在云数据库上白费力气改配置文件。










