当前位置：首页 > article >正文

记录一次MySQL:caching_sha2_password报错

article 2025/1/10 1:21:44

一个报错

在使用客户端登录 MySQL8.0 时，我们经常会遇到下面这个报错：

ERROR 2061 (HY000): Authentication plugin 'caching_sha2_password' reported error: Authentication requires
secure connection

网络上很多帖子教我们将用户认证插件修改成 mysql_native_password 来解决，那么事实上这是怎么一回事呢？本文就来探讨一二。

caching_sha2_password 简介

caching_sha2_password 是 MySQL 8.0.4 引入的一个新的身份验证插件，它的特点从其命名就可以窥探出一二：

sha2_password：其实就是 sha256_password，这是 MySQL5.6 就引入的身份验证插件，其优点是对加盐密码进行多轮 SHA256 哈希，以确保哈希转换更安全。其缺点为它要求使用安全连接或使用RSA 密钥对进行密码交换的未加密连接，因此其身份验证的效率较低。
如果是非 SSL 加密连接，则在连接建立时客户端使用 MySQL Server 端的 RSA 公钥加密用户密
码，Server 端使用 RSA 私钥解密验证密码的正确性，可以防止密码在网络传输时被窥探

注意：SSL 加密连接会不止会加密用户密码，还会加密数据（SQL 请求、返回的结果）；非加密连接只使用 RSA 密钥对进行用户密码的加密。

未加密连接是怎么使用 RSA 密钥对进行密码交换的？

当用户验证成功后，会把用户密码哈希缓存起来。新连接客户端发起登录请求时，MySQL Server 端会判断是否命中缓存，如果没有缓存，对于未加密的连接，caching_sha2_password 插件要求连接建立时使用RSA 进行加密密码交换，否则报错，其过程为：

客户端如果拥有服务端的 RSA 公钥，则使用 --server-public-key-path 选项指定 RSA 公钥文件；
客户端使用 RSA 公钥对用户密码进行加密，请求连接；
服务端使用 RSA 私钥进行解密，验证密码的正确性。

如果客户端没有保存服务端的 RSA 公钥文件，也可以使用 --get-server-public-key 选项从服务器请求公钥，则在建立连接时，服务端会先将 RSA 公钥发送给客户端。

如果 --server-public-key-path、--get-server-public-key 都没有指定，则会报下面这个经典的错误

[root@172-16-21-5 ~] mysql -h172.16.21.4 -utest -ptestpass --ssl-mode=disable
mysql: [Warning] Using a password on the command line interface can be insecure.
ERROR 2061 (HY000): Authentication plugin 'caching_sha2_password' reported error: Authe
ntication requires secure connection.

指定 --get-server-public-key 则能成功登录：

[root@172-16-21-5 ~] mysql -h172.16.21.4 -utest -ptestpass --ssl-mode=disable --getserver-public-key -e "select 1"
mysql: [Warning] Using a password on the command line interface can be insecure.
+---+
| 1 |
+---+
| 1 |

如果 test 用户登陆成功，有了缓存，则下次认证时未加密连接不再要求使用 RSA 密钥对：

[root@172-16-21-5 ~] mysql -h172.16.21.4 -utest -ptestpass --ssl-mode=disable -
e "select 1"
mysql: [Warning] Using a password on the command line interface can be insecure.
+---+
| 1 |
+---+
| 1 |
+---+