0

0

MySQL升级导致应用连接报错怎么办_修改默认身份验证插件设置

P粉602998670

P粉602998670

发布时间:2026-03-19 07:57:26

|

231人浏览过

|

来源于php中文网

原创

MySQL 8.0默认认证插件改为caching_sha2_password导致旧客户端连接失败,解决方法是为现有用户执行ALTER USER ... IDENTIFIED WITH mysql_native_password,并FLUSH PRIVILEGES;或修改my.cnf中default_authentication_plugin并重启mysqld。

mysql升级导致应用连接报错怎么办_修改默认身份验证插件设置

MySQL 8.0 默认 auth_plugin 变成 caching_sha2_password 了

应用连不上 MySQL,报错 Plugin caching_sha2_password could not be loadedClient does not support authentication protocol,基本就是这个原因。MySQL 5.7 升到 8.0 后,default_authentication_pluginmysql_native_password 切成了 caching_sha2_password,而老客户端(比如旧版 JDBC、PHP mysqli、某些 Python MySQL 驱动)压根不认这个新插件。

  • 不是所有客户端都支持 caching_sha2_password:JDBC 8.0+、MySQL Connector/Python 8.0+ 才默认兼容;旧版驱动会直接拒连
  • 改配置只影响新创建的用户,已存在的用户不会自动刷新认证方式
  • 临时绕过方案(如加 ?serverTimezone=UTC&allowPublicKeyRetrieval=true&useSSL=false)治标不治本,还可能引入安全或时区问题

快速修复:给现有用户切回 mysql_native_password

不用动全局配置,直接重置出问题的用户认证方式最稳妥。假设你的应用用的是用户名 app_user,连接的是本地数据库:

ALTER USER 'app_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_password';
  • 必须指定 WITH mysql_native_password,光用 SET PASSWORD 不生效
  • 'app_user'@'%' 要和建用户时的 host 完全一致,查当前用户用 SELECT User, Host FROM mysql.user;
  • 执行完记得 FLUSH PRIVILEGES;,否则部分版本不立即生效
  • 如果用户是 localhost,注意 MySQL 8.0 对 localhost 的解析更严格,有时得用 127.0.0.1 测试连接

一劳永逸:修改 my.cnf 并重启 mysqld

如果你控制数据库服务器,且确认所有客户端都能升级或适配,可以改全局默认插件;但更常见的情况是——干脆统一回退到兼容性更好的老插件:

上班人导航
上班人导航

上班人必备的职场办公导航网站

下载
[mysqld]
default_authentication_plugin = mysql_native_password
  • 配置必须放在 [mysqld] 段下,写在 [client] 或其他段无效
  • 改完要重启 mysqld,不是 reload;systemd 下用 sudo systemctl restart mysqld
  • 重启后新建的用户才会默认用 mysql_native_password,已有用户仍需单独 ALTER USER
  • 某些云数据库(如阿里云 RDS、腾讯云 CDB)不开放 my.cnf 修改权限,这条路走不通,只能走用户级修复

Java 应用连不上?检查 JDBC URL 和驱动版本

即使服务端改了插件,Java 应用也可能因驱动太老继续报错。关键点不在 URL 参数,而在驱动本身:

  • JDBC 5.1.x / 6.0.x 完全不支持 caching_sha2_password,必须升到 8.0.11+
  • URL 加 allowPublicKeyRetrieval=true 是为了配合新插件握手,但如果服务端已切回 mysql_native_password,这个参数反而可能触发警告甚至被新驱动拒绝
  • Maven 依赖要明确指定新版:mysql:mysql-connector-java:8.0.33(别用 runtime scope 隐式引入旧版)
  • Spring Boot 2.4+ 默认带 8.x 驱动,但若项目里显式 exclude 了,或用了 spring-boot-starter-jdbc 而没锁版本,仍可能拉到低版本

最常被忽略的是:改了用户认证方式后没重启应用,连接池里还缓着旧的失败连接;或者开发环境切了插件,测试环境忘了同步。连不上时,先 mysql -u app_user -p -h your-host 手动试一次,排除网络和权限之外的所有干扰。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

1135

2023.10.12

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

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

340

2023.10.27

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

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

381

2024.02.23

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

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

2300

2024.03.06

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

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

380

2024.03.06

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

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

1784

2024.04.07

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

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

588

2024.04.29

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

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

441

2024.04.29

Python WebSocket实时通信与异步服务开发实践
Python WebSocket实时通信与异步服务开发实践

本专题聚焦 Python 在实时通信场景中的开发实践,系统讲解 WebSocket 协议原理、长连接管理、消息推送机制以及异步服务架构设计。内容包括客户端与服务端通信实现、连接稳定性优化、消息队列集成及高并发处理策略。通过完整案例,帮助开发者构建高效稳定的实时通信系统,适用于聊天应用、实时数据推送等场景。

7

2026.03.18

热门下载

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

精品课程

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

共48课时 | 2.6万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 859人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号