如何解决MySQL 8.0的caching_sha2_password连接错误

轻明酱_9012

轻明酱_9012

2026-08-30

984人浏览

原创

根本原因是客户端不支持caching_sha2_password插件要求的rsa公钥交换或tls加密,导致握手失败;解决方法是执行alter user 'user'@'host' identified with mysql_native_password by 'pwd'并立即flush privileges。

如何解决mysql 8.0的caching_sha2_password连接错误

caching_sha2_password 连接失败,不是密码错了,也不是网络不通,而是客户端压根不认这个插件——握手直接中断。最稳的解法是改用户认证方式,不是调配置、不是换驱动(除非你真想长期用新协议)。

怎么确认真是 caching_sha2_password 在报错

别猜,先登录 MySQL 命令行(比如 mysql -u root -p),执行:

SELECT user, host, plugin FROM mysql.user WHERE user = 'your_user';

重点看 plugin 列值。如果显示 caching_sha2_password,且你用的是以下任一环境,基本坐实问题:

  • Navicat 15 以下版本(尤其 12–14)
  • PyMySQL
  • PHP mysqli 扩展 ≤ 7.4(宝塔/AMPPS 默认包常见)
  • JDBC Connector/J
  • Django

注意:'root'@'localhost'、'root'@'127.0.0.1'、'root'@'%' 是三个独立账号,必须分别查、分别处理。

ALTER USER 改插件必须带密码、匹配 host、立刻 FLUSH PRIVILEGES

这是见效最快的操作,但漏掉任意一条都会白忙活甚至锁死账户:

Cn Password Generator
Cn Password Generator

安全的随机密码生成器。支持自定义长度、字符类型(大写/小写字母、数字、特殊符号),排除相似字符,批量生成。纯 Python 标准库,无需 API 密钥。

下载
  • 必须显式重设密码:ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'MyPass123!'; —— 只写 IDENTIFIED WITH mysql_native_password 不带 BY,原密码会被清空
  • host 必须完全匹配:Navicat 默认走 TCP,即 'root'@'127.0.0.1',不是 localhost;Docker 内连宿主机可能是 'appuser'@'172.17.0.1'
  • 执行后必须立刻跟 FLUSH PRIVILEGES;:MySQL 8.0.16+ 权限缓存更严格,不刷就不生效
  • 云数据库(如阿里云 RDS)通常禁写配置文件,ALTER USER 是唯一可行路径

改完服务端,Navicat / JDBC / PyMySQL 还连不上?检查客户端侧缓存和参数

服务端改完了,客户端未必“收到通知”:

  • Navicat 会缓存旧连接配置:必须关掉软件重开,或删掉旧连接、新建一个——它不会自动重协商认证插件
  • JDBC URL 需加参数(仅限内网可信环境):?allowPublicKeyRetrieval=true&useSSL=false,且驱动版本 ≥ 8.0.16
  • PyMySQL ≥ 1.0.2 才原生支持 caching_sha2_password;旧版要么升级,要么换 mysql-connector-python
  • 密码含 @ 或 / 会被 URL 解析吃掉:Navicat 连接里填密码时,建议先 URL 编码,或改用 mysql_native_password 规避

default_authentication_plugin 配置项只管新用户,对老账号无效

在 /etc/my.cnf 或 /etc/mysql/mysql.conf.d/mysqld.cnf 里加:

[mysqld]
default_authentication_plugin = mysql_native_password

重启 MySQL 后,只影响后续 CREATE USER 的新账号,对已存在的 root、admin 等完全没用。Docker 启动加 --default-authentication-plugin=mysql_native_password 同理。很多人改完就以为搞定,结果 SELECT ... FROM mysql.user 一看,plugin 字段还是 caching_sha2_password。

真正容易被忽略的,不是 SQL 写错,而是 host 写成 localhost 却没同步处理 'root'@'localhost',或者 Navicat 连接字符串里 host 是 127.0.0.1 却只改了 'root'@'localhost'。

相关文章

WPS零基础入门到精通全套教程!
WPS零基础入门到精通全套教程!

全网最新最细最实用WPS零基础入门到精通全套教程!带你真正掌握WPS办公! 内含Excel基础操作、函数设计、数据透视表等

下载

相关标签:

mysql word mysql 8.0

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

2023.10.12

3903

8

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.27

831

4

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

2024.02.23

1009

5

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

5741

10

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

2024.03.06

2683

4

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

2024.04.07

5720

11

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

2024.04.29

7561

6

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

1030

5

sql中删除一列的命令是什么
sql中删除一列的命令是什么

在sql中,使用alter table语句可以删除一列,语法为:alter table table_name drop column column_name。想了解更多sql的相关内容,可以阅读本专题下面的文章。

2024.04.29

912

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 178人学习

使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 282人学习