怎样在MySQL 8.0中解决caching_sha2_password身份验证失败问题

阿涛酱_8290

阿涛酱_8290

2026-10-24

931人浏览

原创

navicat连接mysql报错1251或2059,本质是客户端不支持caching_sha2_password认证插件,需用alter user切换为mysql_native_password并刷新权限,且必须匹配user@host、显式重写密码、重启navicat生效。

怎样在mysql 8.0中解决caching_sha2_password身份验证失败问题

连不上不是密码错了,是客户端根本“听不懂”caching_sha2_password插件的握手协议——它要求 RSA 公钥交换或 TLS 加密,而旧版 Navicat、PyMySQL、JDBC 5.1.x 等工具协议栈缺失,直接在认证阶段就断开。

怎么确认真是 caching_sha2_password 在报错

别靠错误信息猜。用还能连上的账号(比如 mysql -u root -p)执行:

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

重点看三列:

  • plugin 列值为 caching_sha2_password 就坐实问题
  • user 和 host 必须完全匹配你连接字符串里的值——'root'@'localhost'、'root'@'127.0.0.1'、'root'@'%' 是三个独立账号,漏查一个都白忙
  • 典型错误包括:ERROR 2059、Authentication plugin 'caching_sha2_password' cannot be loaded、Unable to load authentication plugin

ALTER USER 切换插件必须带密码重写

语法错一步就锁死账号。必须严格按格式执行,不能省略 BY 子句:

word报告自动生成神器
word报告自动生成神器

Word报告自动生成神器。自动生成专业Word文档报告,支持模板填充、目录生成、表格/图表插入、页眉页脚、多级标题、样式主题、批量邮件合并。当用户需要生成Word报告、创建合同文档、批量生成通知/证书、填充Word模板、制作商业计划书时触发。

下载
ALTER USER 'app_user'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'MyPass123!';

常见坑点:

  • 'app_user'@'localhost' 和 'app_user'@'127.0.0.1' 是两个账号,Navicat 默认走后者,只改 localhost 没用
  • 哪怕原密码没变,也必须显式重写;漏掉 BY 'xxx' 会导致密码哈希被清空,账户立即不可用
  • 执行完必须紧跟 FLUSH PRIVILEGES;,否则内存权限缓存不更新,重启 MySQL 也无效
  • 宝塔、phpMyAdmin 界面里点“编辑”常无法修改 plugin 字段,必须进 SQL 标签页手动执行

客户端驱动和工具也要对齐

只改服务端还不够,老版本客户端可能仍握手失败:

  • JDBC 连接串需加参数:allowPublicKeyRetrieval=true&useSSL=false(仅限内网可信环境),且驱动版本至少为 mysql-connector-java:8.0.16
  • PyMySQL 必须 ≥1.0.2 才原生支持 caching_sha2_password;低于此版本要么升级,要么换 mysql-connector-python
  • Node.js 的 mysql2 需显式传参 authPlugin: 'caching_sha2_password',且版本 ≥2.0.0
  • Navicat 12 及更早版本不支持该插件,必须改服务端插件或升级到 Navicat 15+

为什么改 my.cnf 的 default_authentication_plugin 没用

这个配置项只影响「之后新建的用户」,对已存在的 root、repl_user、应用账号等完全无效。很多人改完 [mysqld] 段就重启,发现插件字段还是 caching_sha2_password,就是因为 MySQL 不会自动迁移存量用户元数据。

云数据库(如阿里云 RDS)通常禁止写 /etc/my.cnf,这条路根本走不通;Docker 启动参数 --default-authentication-plugin=mysql_native_password 同样只管新用户,不修复已有账号。真正容易被忽略的是:Navicat 会缓存连接配置,改完服务端后不关软件重开、不删旧连接重建,它可能还在用旧握手参数反复重试——host 写 localhost 却没同步改 'root'@'localhost',或者密码含 @、/ 被 URL 解析吃掉,这些细节比插件切换本身更常导致失败。

相关文章

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

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

下载

相关标签:

mysql word mysql 8.0

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

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2333

6

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.21

1419

5

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

835

5

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.19

3252

5

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.25

5528

4

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.08

1219

3

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.11

5811

4

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

2023.08.14

5042

7

mysql事务隔离级别
mysql事务隔离级别

mysql规范中定义了四种事务隔离级别,不同的隔离级别对事务的处理有所不同。本专题为大家提供mysql事务隔离级别相关的文章内容,大家可以免费体验。

2023.08.16

6754

11

热门下载

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

精品课程

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

共1课时 | 189人学习