MySQL 8.0 Navicat无法连接?权限协议问题解决方法
时间:2026-07-05 07:03
解决 Navicat 连接 MySQL 8 0 时报 ERROR 1045 2059 的完整指南 遇到错误时先别急于怀疑密码输入错误——如果你使用的是 Navicat 15 以下版本(尤其是 12、11),在连接 MySQL 8 0 时遇到 `ERROR 1045` 并附带 ` root
### 解决 Navicat 连接 MySQL 8.0 时报 ERROR 1045 / 2059 的完整指南
遇到错误时先别急于怀疑密码输入错误——如果你使用的是 Navicat 15 以下版本(尤其是 12、11),在连接 MySQL 8.0 时遇到 `ERROR 1045` 并附带 `'root'@'localhost'`,或者直接弹出 `Authentication plugin 'caching_sha2_password' cannot be loaded` 的提示,那么问题基本可以确定是认证插件不兼容导致的。MySQL 8.0 默认采用 `caching_sha2_password` 认证插件,而旧版 Navicat 并不支持该插件,即使密码正确也无法建立连接。
ALTER USER 必须指定 host 才生效
许多用户只修改了 `'root'@'localhost'` 的记录,却仍然报错——原因在于 Navicat 默认使用 TCP 连接,即便在连接设置中填写了 `localhost`,MySQL 实际匹配的可能是 `'root'@'127.0.0.1'` 或 `'root'@'%'`,而这两条记录要么不存在,要么依然使用旧插件。
正确的做法分三步走:
1. **首先查询 root 用户包含哪些 host**:在 MySQL 命令行或管理工具中执行
`SELECT user, host FROM mysql.user WHERE user = 'root';`
如果结果中仅有 `root` + `localhost` 这一条记录,则需要补充一条 `'root'@'127.0.0.1'` 的用户记录。
2. **创建缺失的用户记录**:
`CREATE USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY '你的密码';`
3. **统一将认证插件修改为 mysql_native_password**:
```sql
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的密码';
ALTER USER 'root'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY '你的密码';
```
4. **务必执行刷新权限操作**:
`FLUSH PRIVILEGES;`
这一步容易被忽略,但如不执行,上述修改将不会立即生效。
Navicat 连接设置中填写 127.0.0.1,而非 localhost
在 Windows 系统中,`localhost` 会优先尝试通过命名管道或共享内存进行连接,但 MySQL 服务默认并未启用这些通道;填写 `127.0.0.1` 可强制使用 TCP 协议,连接路径明确,从而精准匹配到 `'root'@'127.0.0.1'` 这条用户记录。
在 Navicat 新建连接时,请注意以下设置:
- **主机名或 IP 地址**:输入 `127.0.0.1`(不是 `localhost`)
- **端口**:确认端口与实际监听端口一致,默认 `3306`,但 XAMPP/MAMP 可能使用 `3307`
- **密码**:必须如实填写,注意大小写敏感,不得留空
Docker 或长期部署建议改 my.cnf
单条 `ALTER USER` 语句只能暂时解决当前用户的问题——容器重启后,新创建的用户仍会继承 `caching_sha2_password` 认证插件。若要一劳永逸,建议直接修改全局默认插件配置:
- **Linux/macOS**:编辑 `/etc/my.cnf`,在 `[mysqld]` 下加一行:
`default_authentication_plugin=mysql_native_password`
- **Windows**:修改 `C:\ProgramData\MySQL\MySQL Server 8.0\my.ini`,同样加该配置
- **Docker**:把自定义 `my.cnf` 挂载到 `/etc/mysql/conf.d/` 目录下
- 修改完成后必须重启 MySQL 服务,否则配置不会生效
注意:`default_authentication_plugin` 设置仅对新创建的用户生效,已有用户仍需单独执行 `ALTER USER` 语句切换插件——这一点最容易被忽略,请务必留意。
来源:https://www.php.cn/faq/2739361.html
本站内容用于信息整理与展示,如有侵权或内容问题请及时联系处理。