连接Docker中mysql 出现：Unable to load authentication plugin 'caching_sha2_password'.

最新推荐文章于 2025-06-01 18:07:55 发布
最新推荐文章于 2025-06-01 18:07:55 发布
阅读量873 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： Docker 数据库操作 Spring Boot IDEA 文章标签： 连接mysql失败 docker中mysql caching_sha2_password
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/weixin_42184538/article/details/86526845
本文解决在IDEA中连接远程或虚拟机Docker的MySQL遇到的java.sql.SQLException错误，涉及不同版本的MySQL认证插件差异，以及如何检查和更新mysql驱动版本。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

在IDEA中连接远程或是虚拟机中Docker的mysql 出现错误如下：java.sql.SQLException: Unable to load authentication plugin ‘caching_sha2_password’.

5.7版本是：default_authentication_plugin=mysql_native_password
8.x版本就是：default_authentication_plugin=caching_sha2_password

查看idea中pom的依赖包版本号
在这里插入图片描述
pom文件中无法直接查看版本号（可以通过在pom文件中右键单击->Diagrams->ShowDependies…点击依赖进行查看）
在这里插入图片描述
mysql驱动已经更新适配了caching_sha2_password 的密码规则，升级到最新版本就可以了，如将版本改为8.0.11版本
在这里插入图片描述
重启Java服务器即可…
若还是有其他错误，欢迎留言，如能帮助，我会尽快回复…

Docker MySql报2059错误: Authentication plugin 'caching_sha2_password' cannot be loaded
隔壁老瓦的专栏
05-13 753
最近在使用Docker安装和配置MySql，按照正常的步骤来安装和配置MySQL，可配置完成后登录MySQL客户端出现了2059错误，于是上各种博客、技术论坛寻求相关的问题解决办法，可是仍然找不到一个针对性的解决方案，直到访问StackOverflow才找到了答案。 1.遇到问题：使用SQLyog(Navicat)进行登录时出现问题 2.在StackOverflow上找到对应的解决办法： ...
Authentication plugin ‘caching_sha2_password‘ cannot be loaded: dlopen(/usr/local/mysql/lib/plugin/c
zhizhixiaoxiao的专栏
03-09 2097
学习docker 配置mysql中， 用navicat链接云服务器docker mysql是报错： dockerAuthentication plugin 'caching_sha2_password' cannot be loaded: dlopen(/usr/local/mysql/lib/plugin/caching_sha2_password.so, 2): image not found 网上解决方案总结来说：需要将mysql的密码校验机制修改成旧版本的。 可以解决，但是对于学习新手注意
Unable to load authentication plugin ‘caching_sha2_password问题解决
weixin_43904170的博客
03-26 3617
【代码】Unable to load authentication plugin ‘caching_sha2_password问题解决。
java.sql.SQLException: Unable to load authentication plugin ‘caching_sha2_password‘.避坑指南
热门推荐
明明如月的技术博客
03-04 6万+
最近遇到了java.sql.SQLException: Unable to load authentication plugin 'caching_sha2_password'.这个报错。 再此分享，希望能够对其他人有帮助， 主要原因8.x版本的验证模块和之前版本不同： 5.x版本是：default_authentication_plugin=mysql_native_password...
JDBC连不上mysql：Unable to load authentication plugin ‘caching_sha2_password‘.
Jules_wwy的博客
06-01 351
步骤二：解压下载的zip文件，把里面的mysql-connector-j-9.30.jar放到你的项目路径下。8版本前是：default_authentication_plugin = mysql_native_password。8版本后是：default_authentication_plugin = caching_sha2_password。最近为一个spring-boot项目下了mysql-9.3.0，结果因为mysql版本太新一直报错连不上。（或者也可以直接换一个低版本的mysql。
Unable to load authentication plugin ‘caching_sha2_password‘
lishuangquan1987的博客
12-16 860
使用DBeaver连接Mysql时报Unable to load authentication plugin 'caching_sha2_password 原因：Mysql8.0以上默认使用密码加密规则为caching_sha2_password 需要修改为mysql_native_password: use mysql Reading table information for completion of table and column names You can turn off this fea
DBeaver连接mysql失败：Unable to load authentication plugin ‘caching_sha2_password‘.
HaiJaine的博客
02-10 6540
这个是因为，mysql8之前的版本使用的密码加密规则是mysql_native_password，但是在mysql8则是caching_sha2_password，所以需要修改密码加密规则。by后面输入密码，可以通过该语句修改密码，若不需要修改密码则输入原来的密码。接下来要做的事情就是修改mysql使用的密码加密规则。到这里就可以正常连接mysql了。通过百度翻译把错误提示翻译一下。使用WIN+R打开cmd对话框。查看用户，主机，插件。接下来开始修改默认插件。查看用户，主机，插件。
Navicat 连接 mysql8 报错：2059 - Authentication plugin ‘caching_sha2_password‘ cannot be loaded:xx
qq_36845919的博客
03-15 1万+
  Navicat 连接 MySQL8 报错：2059 - Authentication plugin ‘caching_sha2_password’ cannot be loaded:xxxx； 问题原因   这是因为 mysql 8 之前密码加密规则为 mysql_native_password，而 MySQL8 之后的加密规则为 caching_sha2_password，也就是说，如果要连接 MySQL，其实只需要将 密码规则 改回 mysql_native_password 即可； 解决方法 1
连接Docker容器的mysql出现：ERROR 2059 (HY000): Authentication plugin 'caching_sha2_password' cannot be loade
weixin_43462069的博客
10-11 600
1.报错描述 使用navicat连接工具，连接报错如下： 2.报错原因说明 由于新版本的MySQL新特性导致的，通过查询mysql mysql> select Host,User,plugin from mysql.user; 查询结果如上，在老版本里，一般使用加密方式为mysql_native_password，因为认证方式改变导致的。 3.解决方案 1.进入容器 docker ...
之docker之MySQL连接ERROR 2059 (HY000): Authentication plugin ‘caching_sha2_password‘ cannot be loaded
灬紫荆灬
02-20 366
报错： ERROR 2059 (HY000): Authentication plugin 'caching_sha2_password' cannot be loaded: /usr/lib64/mysql/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory ...
Unable to load authentication plugin 'caching_sha2_password'
一颗正在努力的小星星的博客
11-19 1万+
**Unable to load authentication plugin 'caching_sha2_password'** 错误原因：听说是由于Mysql8.0以后使用的密码验证方式变成了caching_sha2_password造成的。 首先我们找到mysql配置文件my.ini： 打开，查找default_authentication_plugin（这应该是默认验证方式的配置） 修...
解决MySQL登陆报错：Unable to load authentication plugin ‘caching_sha2_password‘.
蛤？
03-25 1984
输入：alter user 'username' @'localhost' identified with mysql_native_password by 'passwd';输入：select user,host,plugin,authentication_string from user;刷新：FLUSH PRIVILEGES;前言：本文内容为实操记录，仅供参考！输入：use mysql;
Unable to load authentication plugin ‘caching_sha2_password
帝上无天的博客
06-14 1万+
在我使用DBeaver连接MySQL的时候，竟然报错了，错误如下：最后发现问题，是因为MySQL8和MySQL5的一些变更。这是mysql 8.0版本才出现的问题，原因是mysql 8.0 默认使用 caching_sha2_password 身份验证机制 —— 从原来的 mysql_native_password 更改为 caching_sha2_password。8版本前是：default_authentication_plugin= 8版本后是：default_authentication_plugi
Client does not support authentication protocol requested by server； consider upgrading MySQL client
weixin_46245201的博客
07-01 240
Client does not support authentication protocol requested by server; consider upgrading MySQL client at sun.reflect.NativeConstructorAccessorImpl.newInstance0(Native Method) at sun.reflect.NativeConstructorAccessorImpl.newInstance(NativeConstructorAccessor
解决Unable to load authentication plugin ‘caching_sha2_password‘
宋发元
07-26 803
8版本前是：default_authentication_plugin=mysql_native_password。8版本后是：default_authentication_plugin=caching_sha2_password。既然mysql8默认的认证插件是caching_sha2_password` ，那我们就同步 更新驱动即可。不同版本的认证插件不同造成的。更新认证plugin。
Navicat连接mysql时，提示：Unable to load authentication plugin ‘caching_sha2_password‘.
hzgjgr的博客
04-22 3159
Navicat连接mysql时，提示：Unable to load authentication plugin 'caching_sha2_password'.
Unable to load authentication plugin 'caching_sha2_password'.错误
weixin_30617797的博客
08-30 533
今天整合SSM时，在创建连接时一直报错 Unable to load authentication plugin 'caching_sha2_password'. 研究了很久发现是因为MySQL的版本问题 我目前用的MySQL 8.0.15，据网上所说，5.x版本和8.x的区别如下： 5.X版本是：default_authentication_plugin=mysql_native_...
[ERRO] 20250711 15:19:07.966044 [t1gm_presettle] failed to connect mysql, use:0.00sec, msg:Authentication plugin 'caching_sha2_password' cannot be loaded: /usr/local/mysql/lib/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory, code:-2059, svr:localhost:3306, db:A5_Fund, user:a5_ops@pubfund#mgr_pubfund, tx_isolation:serializable, conn:0x7faeb000dad0. [WARN] 20250711 15:19:07.990900 [t1gm_presettle] (01000)adapter failed to login database, name:A5_Fund, use:0.22s, msg:Authentication plugin 'caching_sha2_password' cannot be loaded: /usr/local/mysql/lib/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory [ERRO] 20250711 15:19:07.991397 [t1gm_presettle] (01744)failed to start service. svcname:t1gm_presettle, use:0.22sec. [INFO] 20250711 15:19:07.992583 [t1gm_presettle] service start failed. load adapter:libadp_aboss.so,ABOSS,A5_Fund,Authentication plugin 'caching_sha2_password' cannot be loaded: /usr/local/mysql/lib/plugin/caching_sha2_password.so: cannot open shared object file: No such file or directory
最新发布
07-12
<think>嗯，用户遇到了MySQL连接错误"Authentication plugin 'caching_sha2_password' cannot be loaded"，这通常是由于客户端无法加载新的认证插件导致的。让我结合引用资料和MySQL知识来分析。 用户可能是在升级MySQL后遇到这个问题，因为引用[1]和[4]都提到了升级场景。从错误信息看，核心问题是客户端找不到caching_sha2_password.so文件，这通常发生在： - 客户端版本太旧（如MySQL 5.7客户端连接8.0服务端） - 文件路径配置错误 - Docker环境映射问题（引用[4]） 引用[2][3]提供了重要线索：某些客户端驱动（如Python连接器）还不支持新插件。引用[3]提到的临时解决方案（修改用户认证方式）比较实用，但要注意安全性。 用户可能是开发者或运维人员，正在尝试连接数据库时受阻。ta需要快速可靠的解决方案，同时可能担心数据安全。深层需求应该是既解决连接问题，又不降低系统安全性。 针对这个错误，我可以提供三种层次的解决方案： 1. 临时方案：修改用户认证方式为mysql_native_password（操作简单但安全性略低） 2. 兼容方案：升级客户端或驱动（一劳永逸但可能耗时） 3. 彻底方案：检查插件路径配置（适合文件确实存在的情况） 特别要注意引用[4]的Docker案例，如果用户使用容器，需要确保volume正确挂载了插件目录。另外引用[5]的备份提醒很重要，修改认证方式前应该备份数据。 需要强调新插件的优势（更安全的SHA-256哈希），避免用户误以为新插件不好。对于开发测试环境，临时方案足够；生产环境则建议升级客户端。</think>MySQL 连接报错 `Authentication plugin 'caching_sha2_password' cannot be loaded` 通常发生在 **较旧的 MySQL 客户端或驱动** 尝试连接 **MySQL 8.0+ 服务器**时。这是因为 MySQL 8.0 默认使用了更安全的 `caching_sha2_password` 认证插件，而旧客户端可能缺乏支持该插件所需的库文件 (`caching_sha2_password.so`) 或驱动能力[^1][^2][^4]。 以下是几种解决方案，请根据你的环境选择： ### 🔧 方案一：修改用户认证方式 (推荐临时解决或兼容旧驱动) 这是最常用的方法，将用户的认证插件改回旧的 `mysql_native_password`。**注意：这会降低认证安全性，但能快速解决兼容性问题。** 1. **使用支持新插件的客户端登录 MySQL 服务器** (如 MySQL 8.0 自带的命令行客户端 `mysql` 或支持新插件的 GUI 工具)： ```bash mysql -u root -p ``` 2. **修改目标用户的认证插件和密码**： ```sql -- 将 'your_username' 替换为报错的用户名，'your_new_strong_password' 替换为新密码 ALTER USER 'your_username'@'host' IDENTIFIED WITH mysql_native_password BY 'your_new_strong_password'; FLUSH PRIVILEGES; ``` * `'host'` 需要替换为用户的实际连接来源（如 `'localhost'`, `'%'` 表示任意主机）。 * 例如：`ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'MyNewPass123!';` 3. **尝试重新连接**：使用修改后的密码，用旧客户端或驱动连接，应该可以成功[^1][^3][^4]。 ### ⬆ 方案二：升级客户端或驱动 (推荐长期解决，更安全) 这是最根本的解决方案，确保客户端/驱动支持 `caching_sha2_password`。 1. **升级 MySQL 客户端命令行工具**： * 确保你本地使用的 `mysql` 命令行工具版本与服务器版本兼容（最好是 8.0+）。检查版本：`mysql --version`。 * 如果版本过低（如 5.7），请升级到与服务器匹配的版本。 2. **升级应用程序使用的 MySQL 连接驱动/库**： * **Python (mysql-connector-python, PyMySQL)：** 确保使用支持新插件的较新版本（通常 8.0.11+ 或最新版）。更新：`pip install --upgrade mysql-connector-python` 或 `pip install --upgrade pymysql`[^2]。 * **Java (JDBC)：** 使用 MySQL Connector/J 8.0+ 版本。 * **PHP (PDO, mysqli)：** 确保 PHP 的 MySQL 扩展（通常是 `mysqli` 或 `pdo_mysql`）是针对 MySQL 8.0+ 客户端库编译的，或者使用 `mysqlnd` 驱动并更新到支持新插件的 PHP 版本。 * **其他语言/框架：** 查阅相应 MySQL 连接库的文档，确认支持 `caching_sha2_password` 并升级到该版本。 3. **Docker 环境注意**：确保你连接 MySQL 容器时使用的 `mysql` 客户端命令来自一个包含新插件支持的镜像（如 `mysql:8.0` 客户端容器），或者你宿主机上的 `mysql` 客户端版本足够新[^4]。 ### 🔍 方案三：检查插件路径 (如果文件确实存在但找不到) 如果错误明确提示找不到 `caching_sha2_password.so` 文件（如引用[1][4]中的 `/usr/local/mysql/lib/plugin/caching_sha2_password.so` 或类似路径），但你知道该文件在服务器上实际存在于其他位置： 1. **登录 MySQL 服务器**。 2. **查看插件目录位置**： ```sql SHOW VARIABLES LIKE 'plugin_dir'; ``` 3. **验证文件存在**：在服务器操作系统上，检查 `SHOW VARIABLES` 返回的目录下是否存在 `caching_sha2_password.so` 文件。 4. **解决方案**： * **确保 MySQL 服务进程有权限读取该目录和文件。** * 如果文件确实不在该目录，可能是安装不完整。考虑重新安装 MySQL Server 或复制正确的插件文件到该目录（需谨慎操作）。 * **Docker 用户**：检查 MySQL 容器内 `plugin_dir` 路径下的文件是否存在。如果宿主机映射了 volume，确保插件目录被正确包含在映射中[^4]。 ### 📌 总结选择建议 * **需要快速恢复连接，且环境安全性要求不高（如开发、测试）：** 使用 **方案一**。 * **追求最佳安全性，且能控制客户端/驱动升级：** **方案二** 是首选和长期方案。 * 错误明确指向 `.so` 文件找不到，且确认文件在服务器存在但路径不符：**方案三**。 ### ❓相关问题 1. **MySQL 8.0 默认使用 `caching_sha2_password` 相比旧的 `mysql_native_password` 有哪些安全性优势？** [^3] 2. **在升级 MySQL 服务器到 8.0+ 之前，如何检查现有应用程序的驱动/库是否兼容 `caching_sha2_password` 认证？** [^2][^5] 3. **除了修改用户认证方式和升级客户端，是否可以通过服务器配置强制所有新用户使用 `mysql_native_password`？** [^1] 4. **使用 Docker 运行 MySQL 8.0 时，如何确保宿主机的旧版 `mysql` 客户端能正确连接而不出现此错误？** [^4] 5. **如果需要在生产环境中使用 `caching_sha2_password` 但又必须支持旧客户端，有哪些折中的安全方案？** [^3]
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

悟空宇

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值