MySQL升级后连接异常八成因caching_sha2_password插件不兼容；需先查mysql.user表确认用户plugin值，若为caching_sha2_password，执行ALTER USER切换为mysql_native_password并FLUSH PRIVILEGES。
MySQL升级后连不上，八成是caching_sha2_password在作祟——不是密码错了，也不是网络不通，而是客户端压根不认这个插件。直接改用户认证方式最稳，别碰my.cnf里那个default_authentication_plugin，它对老用户完全没用。
怎么确认真是caching_sha2_password导致的报错
进 MySQL 命令行（用还能登录的账号，比如 root），执行这两条：
-
SHOW VARIABLES LIKE 'default_authentication_plugin';—— 看全局默认值 -
SELECT user, host, plugin FROM mysql.user WHERE user = 'your_app_user';—— 替换成你应用实际用的用户名，比如app或repl_user
如果 plugin 列显示 caching_sha2_password，且你用的是 Navicat ≤14、PyMySQL Authentication plugin 'caching_sha2_password' cannot be loaded、Public Key Retrieval is not allowed、Client does not support authentication protocol requested by server。
ALTER USER必须带主机名+密码重设，漏一个就白干
MySQL 把 'user'@'localhost'、'user'@'127.0.0.1'、'user'@'%' 当作三个独立账号。Navicat 默认走 127.0.0.1，但很多人只改了 localhost 就以为完事。
Word报告自动生成神器。自动生成专业Word文档报告，支持模板填充、目录生成、表格/图表插入、页眉页脚、多级标题、样式主题、批量邮件合并。当用户需要生成Word报告、创建合同文档、批量生成通知/证书、填充Word模板、制作商业计划书时触发。
- 改本地 socket 连接：
ALTER USER 'app'@'localhost' IDENTIFIED WITH mysql_native_password BY 'P@ssw0rd'; - 改 IP 连接（含 Navicat 默认）：
ALTER USER 'app'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'P@ssw0rd'; - 改远程连接：
ALTER USER 'app'@'%' IDENTIFIED WITH mysql_native_password BY 'P@ssw0rd';
注意：IDENTIFIED WITH 后必须跟插件名，BY 后必须跟明文密码——哪怕密码没变，也得写上。漏掉 BY 会清空密码哈希，账号直接锁死。
改完不FLUSH PRIVILEGES等于没改
MySQL 8.0.16+ 权限缓存更严格，ALTER USER 只改内存元数据，不刷缓存就无效。
- 执行完每条
ALTER USER后，立刻跟一句：FLUSH PRIVILEGES; - 宝塔、某些 Docker 环境或云数据库代理下，还得手动重启 MySQL 服务，否则连接池可能继续复用旧握手状态
- Navicat、SQLyog 等工具不用重启软件，但必须删掉旧连接、新建一个，否则它还在用已建立的会话重试
真正麻烦的不是命令本身，而是 root 用户常有双实例：一个走 auth_socket（localhost），一个走密码认证（127.0.0.1 或 %），得分别查、分别改。
