应修改具体用户的认证插件而非全局配置;先查SELECT user,host,plugin FROM mysql.user WHERE user='your_user'确认插件类型,再用ALTER USER 'user'@'host' IDENTIFIED WITH mysql_native_password BY 'password'修正,并执行FLUSH PRIVILEGES。

不能“优雅降级”默认认证插件——你真正要做的,是改用户,不是改全局配置。 MySQL 8.0 的 default_authentication_plugin 只控制新用户的默认插件,对已有用户完全无效。大量人折腾 my.cnf、重启服务、查配置、再连不上,就是卡在这点上。
先确认是不是 caching_sha2_password 在报错
别猜,直接查。用 root 登录 MySQL 命令行后执行:
SELECT user, host, plugin FROM mysql.user WHERE user = 'your_user';
注意三点:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
-
your_user必须替换成你代码或 Navicat 里实际填的用户名,比如app或root -
host是严格匹配项:'localhost'、'127.0.0.1'、'%'是三个完全不同的账号;Navicat 默认走127.0.0.1,但很多人只改了localhost,白忙 - 如果
plugin列返回caching_sha2_password,且你用的是 JDBC 5.1.x、PyMySQL、PHP mysqli 7.x、Navicat ≤14,那问题就锁定了
ALTER USER 必须带 host 和明文密码
这是最常报错的环节。语句缺一不可,漏掉任何一项都会失败或静默清空密码:
- 必须写全
'user'@'host',不能只写'user';'root'@'localhost'和'root'@'127.0.0.1'是两回事 - 必须显式带
BY 'password'—— 即使密码没变,也得重输一遍明文;否则 MySQL 会认为你要清空密码 - 错误示例:
ALTER USER 'root' IDENTIFIED WITH mysql_native_password;→ 缺 host、缺 BY,必报错 - 正确示例:
ALTER USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'MyPass123!';
改完不生效?大概率漏了 FLUSH PRIVILEGES 或客户端复用旧连接
MySQL 8.0.16+ 权限缓存更严格,ALTER USER 不自动刷新认证状态:
- 执行完立刻跟一句:
FLUSH PRIVILEGES;,尤其在宝塔、Docker、某些云镜像里,跳过这步=白改 - Navicat / DBeaver / PHP 连接池等工具不会自动重连,旧连接仍用老插件握手;必须新建连接测试
- 命令行登录时密码含
!、#、$等 shell 特殊字符,用双引号会被 bash 解析(如mysql -u root -p"pass!123"报event not found),得改用单引号:mysql -u root -p'pass!123'
真正容易被忽略的,是 host 的精确匹配和 BY 'password' 的强制要求——这两点踩中任意一个,就等于没改。

















