答案是认证插件不匹配:Navicat 15(尤其早期小版本)与MySQL 8.0默认的caching_sha2_password插件握手失败,需执行SELECT确认plugin值,再对'root'@'localhost'、'root'@'127.0.0.1'、'root'@'%'分别执行ALTER USER...IDENTIFIED WITH mysql_native_password BY 'pwd'并FLUSH PRIVILEGES,最后重启Navicat。

Navicat 15 连不上 Docker 里的 MySQL 8.0,95% 是因为认证插件不匹配——不是 Navicat 有 bug,也不是容器没跑起来,而是 MySQL 8.0 默认用 caching_sha2_password,而 Navicat 15(尤其早期小版本)在某些连接路径下仍会 fallback 到旧握手逻辑,导致握手失败或模型解析异常。
确认是不是 caching_sha2_password 搞的鬼
别猜,直接查。进容器执行:
docker exec -it your-mysql-container mysql -u root -p
登录后运行:
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';
重点看 plugin 列。如果出现 caching_sha2_password,且你连的是 'root'@'127.0.0.1' 或 'root'@'%',那基本就是它了。注意:'root'@'localhost' 和 'root'@'127.0.0.1' 在 MySQL 里是两个独立用户,必须分别处理。
ALTER USER 必须带密码 + 显式指定 host
只改插件不设密码,等于锁死账户;只改一个 host,其他连接方式依然报错。执行时务必按需覆盖:
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_pass';ALTER USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'your_pass';ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass';
改完立刻执行:
Navicat Premium 17.1 Windows x64 历史系列获取入口。该系列扩展 Garnet、PolarDB 等连接支持,并增强可视化查询解释与 Redis 树视图;未核实到公开固定安装包直链。
FLUSH PRIVILEGES;
漏掉这句,修改不会生效。Docker 容器内无需重启 MySQL 进程,但 Navicat 必须完全退出重开——它的连接缓存会复用旧 handshake 参数,不关干净就白改。
Docker 启动时没开远程访问权限
即使认证插件改对了,如果用户本身没被授权从外部 IP 连接,照样连不上。检查结果中是否有 'root'@'%':
- 如果没有,先加用户:
CREATE USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass'; - 再赋权:
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' WITH GRANT OPTION; - 最后再
FLUSH PRIVILEGES;
另外确认启动容器时是否暴露了端口:-p 3306:3306 不可少;若宿主机开了防火墙(如 Windows Defender 防火墙、ufw),也要放行 3306。
Navicat 15 的驱动和缓存陷阱
Navicat 15 自带 mysql-connector-java-8.0.33.jar,理论上支持 caching_sha2_password,但实际表现取决于连接参数和用户配置:
- 如果曾手动替换过驱动(比如塞进
drivers/目录下的 5.1.x 版本),请删掉所有mysql-connector-*.jar,重启 Navicat 让它加载内置驱动 - Windows 下驱动路径通常是:
C:\Program Files\PremiumSoft\Navicat Premium 15\drivers\ - 连接测试前,在 Navicat 中删掉旧连接配置重试,避免缓存干扰
- 密码含
@、/、\等字符时,URL 解析可能出错,建议先用纯字母数字密码验证通路
最易被忽略的一点:Navicat 15 对 MySQL 8.0 的 JSON、GENERATED COLUMN 元数据读取不完整,这不是连接失败的原因,但会导致「设计表」打不开或反向工程字段类型错乱——这种“能查数据但模型崩”现象,和认证问题无关,属于功能边界限制,得接受降级兼容或换 MySQL Workbench。










