error 2059是认证插件不匹配所致,需先查select user, host, plugin from mysql.user where user='root'确认目标用户,再分别对'root'@'localhost'、'root'@'127.0.0.1'或'root'@'%'执行alter user...identified with mysql_native_password by 'pwd'并flush privileges。

ERROR 2059 是认证插件不匹配,不是密码错了
看到 ERROR 2059 或提示 Authentication plugin 'caching_sha2_password' cannot be loaded,基本可以确定:MySQL 8.0 默认用了 caching_sha2_password 插件,而你的 Navicat(尤其是 15 以下版本)、旧版 JDBC 驱动、PHP PDO、甚至某些 Python mysql-connector 版本压根不支持这个插件。这不是输错密码,也不是权限没开,是协议层面“听不懂对方说话”。
必须同时改 'root'@'localhost' 和 'root'@'127.0.0.1'
Navicat 填 localhost 时,Windows 下常走命名管道或共享内存通道,但 MySQL 服务默认不启用这些;实际连接往往落到 'root'@'127.0.0.1' 这条记录上——而它很可能根本不存在,或插件仍是 caching_sha2_password。
- 先查真实用户:
SELECT user, host, plugin FROM mysql.user WHERE user = 'root'; - 如果只看到
'root'@'localhost',就补一条:CREATE USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY '你的密码'; - 再统一修改:
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码'; - 别漏掉:
ALTER USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY '你的密码'; - 必须执行:
FLUSH PRIVILEGES;,否则不生效
Docker 部署的 MySQL 要改 'root'@'%'
用 docker run -e MYSQL_ROOT_PASSWORD=xxx 启动的容器,默认创建的是 'root'@'%' 用户,host 是通配符,不是 localhost。直接改 'root'@'localhost' 完全无效。
- 进容器:
docker exec -it your-mysql-container /bin/bash - 连 MySQL:
mysql -u root -p(注意:Docker 内部端口仍是 3306,不用 -P) - 执行:
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY '你的密码'; - 再执行:
FLUSH PRIVILEGES; - Navicat 连接时 Host 填容器宿主机 IP 或
127.0.0.1(若端口映射了),别填localhost
my.cnf 里改 default_authentication_plugin 是治本但有代价
在 MySQL 配置文件(如 /etc/my.cnf 或 C:\ProgramData\MySQL\MySQL Server 8.0\my.ini)中加一行:
[mysqld] default_authentication_plugin=mysql_native_password
重启 MySQL 后,所有新创建的用户都会默认用 mysql_native_password。但要注意:
- 已有用户不会自动变更插件,仍需手动
ALTER USER - 牺牲了
caching_sha2_password带来的安全增强(比如密码缓存、SHA2 加密强度) - 如果后续要对接支持该插件的新客户端(如新版 Connector/J),反而可能因配置僵化导致兼容问题
真正容易被忽略的是 host 匹配逻辑——'root'@'localhost' 和 'root'@'127.0.0.1' 在 MySQL 里是两条完全独立的用户记录,改错一个就白忙活。











