如何修复MySQL 5.7升级到8.0后出现的权限验证兼容问题?

云涛同学_3666

云涛同学_3666

2026-07-26

495人浏览

原创

答案是修改用户认证插件为mysql_native_password。先执行SELECT User, Host, plugin FROM mysql.user WHERE User = 'your_username'确认plugin为caching_sha2_password,再运行ALTER USER 'your_username'@'host' IDENTIFIED WITH mysql_native_password BY 'password'; FLUSH PRIVILEGES;即可解决兼容性问题。

如何修复mysql 5.7升级到8.0后出现的权限验证兼容问题?

这不是权限配置错了,而是客户端和服务器在“握手”阶段就卡在认证协议上——MySQL 8.0 默认用 caching_sha2_password,而你的客户端(PHP、Node.js、Navicat、Unity 等)还在认 mysql_native_password。

确认是不是 caching_sha2_password 导致的连接失败

别急着改配置,先验证错误是否真源于此。连接失败时,典型报错是:ER_NOT_SUPPORTED_AUTH_MODE 或 Client does not support authentication protocol。

登录 MySQL(用 root 或有权限账号),执行:

SELECT User, Host, plugin FROM mysql.user WHERE User = 'your_username';

如果返回的 plugin 是 caching_sha2_password,而你用的是旧版 Navicat 12、PHP 7.x 的 mysqli、Node.js 的 mysql 包(非 mysql2),那基本就是它了。

  • SHOW GRANTS 正常 ≠ 认证成功——权限语句能查出来,但连接根本进不来
  • 5.7 升级到 8.0 后未运行 mysqld --upgrade=FORCE,也可能导致 mysql.user 表字段不全,间接让插件字段读取异常

临时修复:用 ALTER USER 切换认证插件

这是最快见效、无需重启服务的方法,适合开发/测试环境快速验证。

MySQL8 CRM Schema Design Expert
MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理(CRM)系统设计、评审、优化或生成数据库模式时,应使用此项技能。

下载

在 MySQL 命令行中执行(把 your_username 和 your_password 换成真实值):

ALTER USER 'your_username'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';<br>FLUSH PRIVILEGES;
  • 若要允许远程连接,把 'localhost' 改成 '%' 或具体 IP,如 '192.168.1.100'
  • 修改后务必执行 FLUSH PRIVILEGES;,否则不会生效
  • 该操作只影响指定用户,不影响其他用户或全局默认设置
  • 不推荐长期用于生产环境——mysql_native_password 安全性弱于 caching_sha2_password

为什么 ALTER USER 后还是连不上

执行了 ALTER USER 'user'@'host' IDENTIFIED WITH mysql_native_password BY 'pwd' 却仍报 SQLSTATE[HY000] [2054] 或 ERROR 1251,常见原因有三个:

  • 漏掉 FLUSH PRIVILEGES;:权限变更不会自动生效,必须手动刷新
  • host 不匹配:比如应用连的是 'user'@'192.168.1.100',但你只改了 'user'@'localhost';查当前连接来源用 SELECT user, host FROM mysql.user WHERE user = 'user';
  • 客户端缓存旧握手逻辑:老版 Navicat、DBeaver 或某些 Java 连接池会复用连接上下文,重启客户端比重启 MySQL 更有效

长期方案:升级客户端驱动或显式启用新协议

治本的方式不是降级服务器,而是让客户端跟上节奏。

  • Java:用 mysql-connector-java ≥ 8.0.12,连接串加 ?allowPublicKeyRetrieval=true&useSSL=false&serverTimezone=UTC;5.1.x 驱动根本不支持 caching_sha2_password,升级是唯一解
  • PHP:mysqlnd ≥ 8.0.0(对应 PHP ≥ 7.4),旧版 PHP 5.x 或 7.0–7.3 的 mysqli 扩展无法协商新协议
  • Python:弃用 MySQLdb(已停止维护),改用 pymysql 或 mysql-connector-python ≥ 8.0.12
  • 驱动不升级,只调服务端参数,会在长连接复用、连接池回收等场景偶发握手失败——这点最容易被忽略

真正容易被忽略的点是:即使你改了用户插件,如果客户端驱动版本太旧,或者连接池没清空、没重启,它还是会拿旧握手缓存去连,报错看起来一模一样,但根源不在服务端。

相关专题

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

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

2023.10.12

4663

8

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

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

2023.10.27

971

4

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

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

2024.02.23

1229

5

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

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

2024.03.06

6661

10

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

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

2024.03.06

3403

4

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

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

2024.04.07

6640

11

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

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

2024.04.29

9141

6

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

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

2024.04.29

1230

5

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

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

2024.04.29

1092

5

热门下载

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

精品课程

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

共1课时 | 193人学习