MySQL 报错:Access denied for user ‘root‘@‘localhost‘ 详解

MySQL 报错:Access denied for user 'root'@'localhost' 详解

一、错误含义

复制代码
ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)

这个错误表示 MySQL 拒绝了 root 用户的连接请求。关键信息:

部分 含义
ERROR 1045 认证失败错误码
root@localhost 用 root 用户从 localhost 连接
using password: YES 提供了密码,但密码不对
using password: NO 没提供密码(如果显示 NO,说明 -p 后面没输入密码)

二、常见原因

原因 说明
密码错误 输入的密码与 root 用户的实际密码不一致
密码为空 root 用户没有设置密码,但命令中用了 -p
认证插件问题 MySQL 8 默认使用 caching_sha2_password,旧客户端不兼容
用户名错误 用户不是 root,或 root 不允许从 localhost 连接
端口错误 连接到了错误的 MySQL 实例
环境变量干扰 MYSQL_PWD 环境变量覆盖了输入的密码

注意 :第一条 [Warning] Using a password on the command line interface can be insecure 只是警告,不是错误。它提示你"在命令行里明文写密码不安全",但不会影响连接。真正的问题是下面的 ERROR 1045。

三、排查步骤

1. 确认密码是否正确

bash 复制代码
mysql -u root -p

回车后输入密码。如果密码记不清了,尝试以下常见密码:

  • 空密码(直接回车)
  • root
  • 123456
  • 安装 MySQL 时设置的密码

2. 确认是否真的设置了密码

有些安装方式(如 MySQL 8 的默认安装)会为 root 用户生成一个临时密码,需要查看日志:

bash 复制代码
# Linux
grep 'temporary password' /var/log/mysqld.log

# Windows,查看 MySQL 数据目录下的 .err 文件

3. 检查是否连接到了正确的实例

bash 复制代码
# 指定端口
mysql -u root -p -P 3306

# 指定主机
mysql -u root -p -h 127.0.0.1

如果你的机器上装了多个 MySQL 实例,可能连到了错误的那个。

4. 检查环境变量

Windows 下如果设置了 MYSQL_PWD 环境变量,它会覆盖你手动输入的密码:

bash 复制代码
echo %MYSQL_PWD%

如果有值,清掉它:

bash 复制代码
set MYSQL_PWD=

四、忘记密码怎么办

如果确实忘了 root 密码,可以跳过权限验证重置。

Windows 下重置

第一步:停止 MySQL 服务

bash 复制代码
net stop mysql

服务名可能是 mysql、mysql80、MySQL,用 services.msc 查看。

第二步:以跳过权限验证方式启动

bash 复制代码
mysqld --skip-grant-tables --console

这个命令会占用当前终端,不要关闭。

第三步:新开一个终端,连接 MySQL

bash 复制代码
mysql -u root

此时不需要密码。

第四步:重置密码

MySQL 8:

sql 复制代码
FLUSH PRIVILEGES;
ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码';

MySQL 5.7:

sql 复制代码
UPDATE mysql.user SET authentication_string = PASSWORD('新密码') 
WHERE User = 'root' AND Host = 'localhost';
FLUSH PRIVILEGES;

第五步:重启 MySQL 服务

关闭跳过权限验证的进程,正常启动服务:

bash 复制代码
net start mysql

用新密码连接验证。

Linux 下重置

bash 复制代码
# 停止服务
sudo systemctl stop mysqld

# 跳过权限验证启动
sudo mysqld_safe --skip-grant-tables &

# 连接
mysql -u root

# 重置密码
FLUSH PRIVILEGES;
ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码';

# 重启
sudo systemctl restart mysqld

五、认证插件问题

MySQL 8 默认使用 caching_sha2_password 插件,部分旧客户端或 JDBC 驱动不兼容,可能表现为"密码正确但认证失败"。

修改认证插件:

sql 复制代码
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '新密码';
FLUSH PRIVILEGES;

Java 项目中如果连接 MySQL 8 报认证错误,检查 JDBC URL 是否加了参数:

复制代码
jdbc:mysql://localhost:3306/mydb?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai

六、权限问题

如果密码正确但仍被拒绝,可能是 root 用户没有从 localhost 连接的权限。

以跳过权限方式启动后,检查权限表:

sql 复制代码
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';

如果 host 不是 localhost 或 %,可以添加:

sql 复制代码
CREATE USER 'root'@'localhost' IDENTIFIED BY '密码';
GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;

七、关于密码安全警告

复制代码
[Warning] Using a password on the command line interface can be insecure.

这只是提醒:mysql -u root -p123456 这种把密码写在命令行里的方式不安全,因为命令会被记录到 shell 历史中。

推荐方式:

bash 复制代码
# 交互式输入,密码不回显
mysql -u root -p

# 使用配置文件
mysql --defaults-extra-file=/path/to/my.cnf

my.cnf 内容:

ini 复制代码
[client]
user=root
password=你的密码

并设置文件权限:

bash 复制代码
chmod 600 /path/to/my.cnf

八、总结

问题 解决方案
密码错误 重新输入正确密码
忘记密码 跳过权限验证重置
密码为空 去掉 -p 或直接回车
认证插件不兼容 改为 mysql_native_password
权限不足 检查 mysql.user 表的 host 字段
命令行密码警告 用交互式 -p 或配置文件

Access denied 的核心就是认证失败,99% 的情况是密码不对。先确认密码是否正确,再检查认证插件和权限表。忘记密码时,跳过权限验证是标准操作,重置后立即恢复正常启动。命令行密码警告不影响连接,但为了安全,建议改用交互式输入或配置文件。# MySQL 报错:Access denied for user 'root'@'localhost' 详解

一、错误含义

复制代码
ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)

这个错误表示 MySQL 拒绝了 root 用户的连接请求。关键信息:

部分 含义
ERROR 1045 认证失败错误码
root@localhost 用 root 用户从 localhost 连接
using password: YES 提供了密码,但密码不对
using password: NO 没提供密码(如果显示 NO,说明 -p 后面没输入密码)

二、常见原因

原因 说明
密码错误 输入的密码与 root 用户的实际密码不一致
密码为空 root 用户没有设置密码,但命令中用了 -p
认证插件问题 MySQL 8 默认使用 caching_sha2_password,旧客户端不兼容
用户名错误 用户不是 root,或 root 不允许从 localhost 连接
端口错误 连接到了错误的 MySQL 实例
环境变量干扰 MYSQL_PWD 环境变量覆盖了输入的密码

注意 :第一条 [Warning] Using a password on the command line interface can be insecure 只是警告,不是错误。它提示你"在命令行里明文写密码不安全",但不会影响连接。真正的问题是下面的 ERROR 1045。

三、排查步骤

1. 确认密码是否正确

bash 复制代码
mysql -u root -p

回车后输入密码。如果密码记不清了,尝试以下常见密码:

  • 空密码(直接回车)
  • root
  • 123456
  • 安装 MySQL 时设置的密码

2. 确认是否真的设置了密码

有些安装方式(如 MySQL 8 的默认安装)会为 root 用户生成一个临时密码,需要查看日志:

bash 复制代码
# Linux
grep 'temporary password' /var/log/mysqld.log

# Windows,查看 MySQL 数据目录下的 .err 文件

3. 检查是否连接到了正确的实例

bash 复制代码
# 指定端口
mysql -u root -p -P 3306

# 指定主机
mysql -u root -p -h 127.0.0.1

如果你的机器上装了多个 MySQL 实例,可能连到了错误的那个。

4. 检查环境变量

Windows 下如果设置了 MYSQL_PWD 环境变量,它会覆盖你手动输入的密码:

bash 复制代码
echo %MYSQL_PWD%

如果有值,清掉它:

bash 复制代码
set MYSQL_PWD=

四、忘记密码怎么办

如果确实忘了 root 密码,可以跳过权限验证重置。

Windows 下重置

第一步:停止 MySQL 服务

bash 复制代码
net stop mysql

服务名可能是 mysql、mysql80、MySQL,用 services.msc 查看。

第二步:以跳过权限验证方式启动

bash 复制代码
mysqld --skip-grant-tables --console

这个命令会占用当前终端,不要关闭。

第三步:新开一个终端,连接 MySQL

bash 复制代码
mysql -u root

此时不需要密码。

第四步:重置密码

MySQL 8:

sql 复制代码
FLUSH PRIVILEGES;
ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码';

MySQL 5.7:

sql 复制代码
UPDATE mysql.user SET authentication_string = PASSWORD('新密码') 
WHERE User = 'root' AND Host = 'localhost';
FLUSH PRIVILEGES;

第五步:重启 MySQL 服务

关闭跳过权限验证的进程,正常启动服务:

bash 复制代码
net start mysql

用新密码连接验证。

Linux 下重置

bash 复制代码
# 停止服务
sudo systemctl stop mysqld

# 跳过权限验证启动
sudo mysqld_safe --skip-grant-tables &

# 连接
mysql -u root

# 重置密码
FLUSH PRIVILEGES;
ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码';

# 重启
sudo systemctl restart mysqld

五、认证插件问题

MySQL 8 默认使用 caching_sha2_password 插件,部分旧客户端或 JDBC 驱动不兼容,可能表现为"密码正确但认证失败"。

修改认证插件:

sql 复制代码
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '新密码';
FLUSH PRIVILEGES;

Java 项目中如果连接 MySQL 8 报认证错误,检查 JDBC URL 是否加了参数:

复制代码
jdbc:mysql://localhost:3306/mydb?useSSL=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai

六、权限问题

如果密码正确但仍被拒绝,可能是 root 用户没有从 localhost 连接的权限。

以跳过权限方式启动后,检查权限表:

sql 复制代码
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';

如果 host 不是 localhost 或 %,可以添加:

sql 复制代码
CREATE USER 'root'@'localhost' IDENTIFIED BY '密码';
GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;

七、关于密码安全警告

复制代码
[Warning] Using a password on the command line interface can be insecure.

这只是提醒:mysql -u root -p123456 这种把密码写在命令行里的方式不安全,因为命令会被记录到 shell 历史中。

推荐方式:

bash 复制代码
# 交互式输入,密码不回显
mysql -u root -p

# 使用配置文件
mysql --defaults-extra-file=/path/to/my.cnf

my.cnf 内容:

ini 复制代码
[client]
user=root
password=你的密码

并设置文件权限:

bash 复制代码
chmod 600 /path/to/my.cnf

八、总结

问题 解决方案
密码错误 重新输入正确密码
忘记密码 跳过权限验证重置
密码为空 去掉 -p 或直接回车
认证插件不兼容 改为 mysql_native_password
权限不足 检查 mysql.user 表的 host 字段
命令行密码警告 用交互式 -p 或配置文件

Access denied 的核心就是认证失败,99% 的情况是密码不对。先确认密码是否正确,再检查认证插件和权限表。忘记密码时,跳过权限验证是标准操作,重置后立即恢复正常启动。命令行密码警告不影响连接,但为了安全,建议改用交互式输入或配置文件。

相关推荐
旋风菠萝7 小时前
HashMap和CurrentHashMap的key可以为空吗
java·数据库·redis
开开心心就好8 小时前
PDF水印怎么去掉?勾选对象再点匹配
java·前端·mysql·支持向量机·pdf·音视频·模拟退火算法
隔窗听雨眠9 小时前
数据管理系统弹性调度的资源模型与实战路径
数据库·分布式系统·弹性调度
Flynn Liang9 小时前
Java 虚拟线程别乱用:I/O 密集型服务的线程模型与并发度计算
java·spring boot·性能优化·高并发·线程池·虚拟线程
Nturmoils9 小时前
数据库选型 POC:订单系统怎么验收候选
数据库
飞奔的瓜牛9 小时前
Zabbix 部署与实战监控手册:Java 服务、端口、进程与邮件/企微告警
java·企业微信·zabbix
Java展博10 小时前
[Go 后端转场] 从 try-catch 到 if err != nil:写惯 Java 的人第一次上手最别扭的 4 件事
java·开发语言·golang
starzy199010 小时前
Hadoop介绍总结:一张图理清组件、生态与版本
java·hadoop
yyuuuzz11 小时前
nginx 502 排查,先看上游超时那一行
android·java·运维·nginx·502
Java后端的Ai之路11 小时前
Java并发编程25-集合的线程安全
java·安全·面试