MySQL Error 1045: Access denied for user 'root'@'localhost' (using password: YES/NO)

Question

MySQL Error 1045: Access denied for user 'root'@'localhost' (using password: YES/NO) 是数据库管理中常见的连接错误。该问题通常出现在尝试使用root账户登录MySQL时，系统提示访问被拒绝。可能原因包括：密码错误、用户权限配置不当、匿名用户冲突、或MySQL服务未正确加载权限表。当"using password"显示为YES时，多为密码不匹配；若为NO，则可能是客户端未提供密码或配置文件中遗漏。此外，跳过权限验证启动后未重置密码也可能导致此问题。需检查用户认证插件、加密方式及配置文件（如my.cnf）中的host、user设置，确保登录请求与授权记录匹配。

Answer 1

1. 错误现象与基础排查

MySQL Error 1045 是数据库管理员在日常维护中最常遇到的连接错误之一。当执行 mysql -u root -p 命令时，系统返回：

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

或

ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: NO)

前者表示客户端尝试使用密码认证但失败；后者则说明未提供密码或配置中缺失凭证信息。

• 检查输入密码是否正确（注意大小写和特殊字符）
• 确认是否启用了密码策略插件如 validate_password
• 查看 MySQL 错误日志路径：/var/log/mysql/error.log 或通过 SHOW VARIABLES LIKE 'log_error';

2. 用户权限与认证机制分析

字段	说明
Host	指定用户可从哪个主机连接，'localhost' 不等于 '127.0.0.1'
User	用户名，区分大小写取决于操作系统和配置
authentication_string	加密后的密码字符串
plugin	认证插件类型，常见为 caching_sha2_password 或 mysql_native_password

可通过如下 SQL 查询当前授权表：

USE mysql;
SELECT Host, User, authentication_string, plugin FROM user WHERE User = 'root';

若发现 plugin 为 caching_sha2_password 而客户端不支持该协议，则可能导致拒绝访问。

3. 配置文件与启动参数影响

MySQL 的行为受多个配置文件控制，优先级顺序如下：

1. /etc/my.cnf
2. /etc/mysql/my.cnf
3. ~/.my.cnf
4. DATADIR/my.cnf

检查是否存在以下配置项：

[client]
user=root
password=yourpassword

[mysqld]
skip-grant-tables  # 若存在此行，将跳过权限验证，需移除！
bind-address=127.0.0.1

特别注意 skip-grant-tables 模式下修改密码后未重启服务会导致权限系统失效。

4. 匿名用户与 Host 冲突问题

某些安装过程中会创建匿名用户（User=''），这些账户可能干扰 root 登录流程。

-- 查看所有用户
SELECT Host, User FROM mysql.user;

-- 删除匿名用户
DELETE FROM mysql.user WHERE User = '';
FLUSH PRIVILEGES;

此外，'root'@'localhost' 与 'root'@'127.0.0.1' 在 Unix Socket 和 TCP/IP 连接中有本质区别：

graph TD A[客户端连接请求] --> B{目标地址} B -->|localhost| C[使用Unix Socket] B -->|127.0.0.1| D[使用TCP/IP] C --> E[匹配 Host='localhost'] D --> F[匹配 Host='127.0.0.1']

5. 密码重置与安全恢复流程

当无法正常登录时，可通过安全模式重置 root 密码：

# 步骤1：停止MySQL服务
sudo systemctl stop mysql

# 步骤2：以跳过权限方式启动
sudo mysqld_safe --skip-grant-tables --skip-networking &

# 步骤3：无密码登录
mysql -u root

# 步骤4：更新密码（MySQL 8.0+语法）
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'NewSecurePass!123';
FLUSH PRIVILEGES;

完成后务必重启服务并验证连接。

6. 加密方式兼容性与客户端适配

自 MySQL 8.0 起默认使用 caching_sha2_password 插件，部分旧客户端（如 PHP 7.x、JDBC 5.x）不支持。

解决方案包括：

• 更改认证方式以兼容老系统
• 升级客户端驱动至支持新协议版本

-- 修改root用户认证插件
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';
-- 或全局设置默认插件
SET GLOBAL default_authentication_plugin = 'mysql_native_password';

7. 多实例环境下的权限隔离

在运行多个 MySQL 实例时，每个实例拥有独立的数据目录和套接字文件，容易混淆连接目标。

典型场景：

mysql -S /tmp/mysql.sock -u root   # 连接默认实例
mysql -S /tmp/mysql2.sock -u root   # 可能未设置相同密码

建议统一管理各实例的 my.cnf 配置，并使用命名套接字或端口区分。