如何在安装MySQL8.0后配置默认身份验证插件为mysql_native_password?

雨晨姑娘_2264

雨晨姑娘_2264

2026-10-30

124人浏览

原创

MySQL 8.0默认使用caching_sha2_password插件,因要求客户端支持RSA或TLS,而Navicat 12等旧工具不兼容,导致认证阶段报错2059;须用ALTER USER精确匹配host并指定密码切换插件,再执行FLUSH PRIVILEGES生效。

如何在安装mysql8.0后配置默认身份验证插件为mysql_native_password?

MySQL 8.0 安装后默认用 caching_sha2_password,不改就直接导致 Navicat、旧版 PHP/Python 驱动、Docker 内客户端等连不上——这不是密码错,是协议不认。

为什么新装 MySQL 8.0 连接报错“Client does not support authentication protocol requested by server”

MySQL 8.0.4 起,默认身份验证插件从 mysql_native_password 换成了 caching_sha2_password。这个插件更安全(支持 SHA-256、可缓存凭据),但要求客户端也支持 RSA 密钥交换或启用 SSL;而 Navicat 12 及更早、PHP MySQLi 扩展(mysqlnd 未更新)、某些 Python mysql-connector 版本,压根不加载该插件,连接时直接中断。

常见错误信息包括:

  • Authentication plugin 'caching_sha2_password' cannot be loaded
  • Error No. 2059(Navicat)
  • Authentication requires secure connection(主从复制场景)

ALTER USER 切换单个用户插件(最常用、最安全)

只改你实际要用的账号(比如 root 或应用用户),不影响其他用户,也不动全局配置。

  • 必须用 ALTER USER ... IDENTIFIED WITH mysql_native_password BY 'password',不能只写 IDENTIFIED WITH 省略 BY——否则原密码被清空,账号锁死
  • host 必须完全匹配:如果你用 127.0.0.1 连,就得改 'root'@'127.0.0.1',不是 'root'@'localhost';远程连接要单独改 'user'@'%' 或具体 IP
  • 执行完必须运行 FLUSH PRIVILEGES(MySQL 8.0.16+ 多数自动刷新,但显式执行更稳)
  • 如果提示 ERROR 1396 (HY000),说明用户不存在,先用 CREATE USER 创建再改

示例(改本地 root):

kashen-mysql DDLtoExcel
kashen-mysql DDLtoExcel

解析 MySQL 8.0 的 DDL 脚本,并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景,导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理,每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。

下载
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_secure_password';
FLUSH PRIVILEGES;

修改 my.cnf 让新建用户默认用 mysql_native_password(仅限开发/测试环境)

加了这行,后续 CREATE USER 的账号才会默认走 mysql_native_password;已有用户**不受影响**,仍需手动 ALTER USER。

  • 编辑配置文件(如 /etc/mysql/my.cnf 或 /usr/my.cnf),在 [mysqld] 段落下添加:
default_authentication_plugin=mysql_native_password
  • Linux 下重启服务:sudo systemctl restart mysql
  • macOS Homebrew:brew services restart mysql
  • 云数据库(如阿里云 RDS、AWS RDS)通常禁止修改此配置,只能走 ALTER USER 方式

命令行或客户端配置临时绕过(适合调试或 CI 环境)

不改服务端,只让客户端主动声明用老插件,适合 Docker 启动容器、CI 脚本或本地开发快速验证。

  • 命令行连接时加参数:mysql -u user -p --default-auth=mysql_native_password
  • 或在 ~/.my.cnf 的 [client] 段落加:
[client]
default_authentication_plugin = mysql_native_password

注意:~/.my.cnf 文件权限必须是 600(chmod 600 ~/.my.cnf),否则 MySQL 客户端会忽略它。

容易被忽略的一点:MySQL 8.0.34 起 mysql_native_password 已被标记为 deprecated,8.4 默认禁用,9.0 将彻底移除——所以生产环境长期方案应是升级客户端驱动并启用 SSL,而不是依赖这个降级配置。

相关专题

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

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

2023.10.12

4623

8

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

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

2023.10.27

951

4

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

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

2024.02.23

1209

5

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

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

2024.03.06

6621

10

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

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

2024.03.06

3363

4

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

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

2024.04.07

6600

11

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

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

2024.04.29

9061

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

1072

5

热门下载

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

精品课程

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

共1课时 | 193人学习