讲师中心 微信公众号
AI工具推荐 视频效率加速

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

轻明酱_9012

轻明酱_9012

发布时间:2026-08-30 09:29:07

|

984人浏览过

|

来源于php中文网

原创

根本原因是客户端不支持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 < 1.0.2
  • PHP mysqli 扩展 ≤ 7.4(宝塔/AMPPS 默认包常见)
  • JDBC Connector/J < 8.0.16
  • Django < 3.1 默认配置

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

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

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

Word2md
Word2md

文档转 Markdown 转换器 - 将 DOCX、PPTX、Excel 文件转换为 Markdown。用于从 Word 文档、PowerPoint 演示文稿或 E... 提取内容。

下载
  • 必须显式重设密码: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基础操作、函数设计、数据透视表等

下载

相关标签:

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

热门AI工具

更多
PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

相关专题

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

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

3923

2023.10.12

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

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

831

2023.10.27

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

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

1029

2024.02.23

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

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

5761

2024.03.06

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

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

2703

2024.03.06

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

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

5740

2024.04.07

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

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

7581

2024.04.29

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

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

1030

2024.04.29

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

0

2026.09.30

热门下载

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

精品课程

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

共1课时 | 178人学习

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

共2课时 | 282人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn