MySQL 8.0 默认认证插件 caching_sha2_password 与旧客户端不兼容,解决方法包括:Navicat 12 改用户插件为 mysql_native_password;JDBC 必须升级驱动至 8.0+ 并配置 URL 参数;Docker 启动时通过 --default-authentication-plugin 指定默认插件。

MySQL 8.0 默认使用 caching_sha2_password 认证插件,但老版本客户端(如 Navicat 12、旧版 JDBC 驱动、某些 Python MySQL 连接库)不支持该插件,直接报错 Authentication plugin 'caching_sha2_password' cannot be loaded。问题本质是协议不兼容,不是密码错了——改插件或换驱动都能解决,但选哪种得看环境约束。
Navicat 12 连不上:优先改用户认证方式
Navicat 12 自带的 MySQL 驱动较旧,升级驱动需手动替换 mysql-connector-java 或重装新版 Navicat(15+ 才原生支持 caching_sha2_password)。更稳妥的做法是把目标用户切回 mysql_native_password:
- 先用命令行登录 MySQL:
mysql -u root -p - 执行两条关键语句(注意替换
root和密码):ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';<br>FLUSH PRIVILEGES;
- 如果要允许远程连接,把
'localhost'换成'%',但需确认防火墙和bind-address允许外连 - Navicat 不需要重启,直接测试新连接即可
JDBC 连接报错 SQLException:检查驱动版本和 URL 参数
Java 应用连 MySQL 8.0 报 Unable to load authentication plugin 'caching_sha2_password',大概率是用了 mysql-connector-java:5.1.x。必须升级到 8.0+ 驱动,并在连接 URL 中显式指定认证插件:
Word报告自动生成神器。自动生成专业Word文档报告,支持模板填充、目录生成、表格/图表插入、页眉页脚、多级标题、样式主题、批量邮件合并。当用户需要生成Word报告、创建合同文档、批量生成通知/证书、填充Word模板、制作商业计划书时触发。
- 依赖换成
mysql:mysql-connector-java:8.0.33或更高(Maven) - URL 加上参数:
?serverTimezone=UTC&allowPublicKeyRetrieval=true&useSSL=false - 如果仍想用
mysql_native_password,追加:&defaultAuthenticationPlugin=mysql_native_password - 5.1.x 驱动硬加参数也无效,必须换驱动
Docker 部署 MySQL 8.0:启动时就禁用新插件
在容器里反复改用户插件很麻烦,推荐从源头控制——启动时强制默认认证方式:
- 在
docker-compose.yml的command中加入:--default-authentication-plugin=mysql_native_password
- 或挂载自定义配置文件,在
/etc/my.cnf的[mysqld]段写:default-authentication-plugin=mysql_native_password
- 这样新建的所有用户都默认用
mysql_native_password,不用每个用户单独 ALTER - 已有用户仍需手动改(
ALTER USER ... IDENTIFIED WITH ...),配置只影响后续创建
改插件后要注意的权限细节
mysql_native_password 虽然兼容性好,但安全性比 caching_sha2_password 低(不支持 RSA 密钥交换、无密码缓存优化)。生产环境若必须降级,至少做到:
- 仅对必要客户端用户降级(比如只改
'navicat_user'@'%',不动'admin'@'localhost') - 确保密码强度足够,避免弱口令被爆破
- 如果用
ALTER USER ... PASSWORD EXPIRE NEVER,记得评估密码轮换策略是否失效 -
FLUSH PRIVILEGES必须执行,否则修改不生效——这点容易漏,尤其在脚本中忘记加










