---
title: phpMyAdmin 登录报错 1698：root 用户认证插件与主机限制排查
description: MySQL 5.7 及 8 起 root 默认使用 auth_socket 或 caching_sha2_password 插件，phpMyAdmin 无法用 root 登录并报 mysqli_real_connect() (HY000/1698)。本文面向企业运维，说明适用场景、准备与风险、创建专用超级用户或调整 root 认证插件的步骤、验证方法、回退建议与常见问题。
url: "https://www.lanever.com/docs/phpmyadmin-%e7%99%bb%e5%bd%95%e6%8a%a5%e9%94%99-1698%ef%bc%9aroot-%e7%94%a8%e6%88%b7%e8%ae%a4%e8%af%81%e6%8f%92%e4%bb%b6%e4%b8%8e%e4%b8%bb%e6%9c%ba%e9%99%90%e5%88%b6%e6%8e%92%e6%9f%a5/"
updated: "2026-10-12"
category: Linux
---

# phpMyAdmin 登录报错 1698：root 用户认证插件与主机限制排查

> **参考来源与致谢**
>
>
>
> - **引用来源：**[Can't log into phpMyAdmin: mysqli_real_connect(): (HY000/1698): Access denied for user 'root'[at]'localhost' - DevAnswers.co](https://devanswers.co/phpmyadmin-access-denied-for-user-root-localhost/)
> - **原作者：**原页面署名作者或发布机构（剪藏记录未保存可核验的个人署名）
> - **感谢词：**感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写，并非原文转载；如权利人需要更正署名或来源信息，请联系本站。

## 适用场景

通过 phpMyAdmin 登录 MySQL 时出现类似报错：`mysqli_real_connect(): (HY000/1698): Access denied for user 'root'[at]'localhost'`。该错误通常不是密码错误，而是认证方式或主机范围不匹配。常见于 MySQL 5.7 及 8 以上版本，root 账户默认使用 `auth_socket` 或 `caching_sha2_password` 插件，而 phpMyAdmin 依赖的 PHP 扩展可能只支持 `mysql_native_password`。

其他可能原因：root 密码已遗忘；root 的 host 值不允许来自 phpMyAdmin 所在主机；使用非 root 账户登录但凭据或权限不正确。MySQL 5.6 及以下一般可直接用 root 登录，若仍失败，多属密码或 host 配置问题。

## 准备与风险

- 操作前备份 MySQL 用户表与配置：`mysqldump --system=users mysql > [备份文件路径]`，或至少导出 `mysql.user` 相关数据。
- 在测试环境先验证，确认 phpMyAdmin 与 PHP 版本对认证插件的支持情况。
- 修改 root 认证插件会改变本机 socket 登录行为，可能影响依赖 `auth_socket` 的自动化脚本。
- 生产环境建议新建专用超级用户，而非直接放开 root 远程登录。
- 所有密码使用强随机值，不要写入脚本明文或版本库。

## 处理步骤

### 方法一：为 phpMyAdmin 创建专用超级用户（推荐）

1. 以系统管理员身份登录 MySQL：
   ```
   sudo mysql -u root -p
   ```

   若 root 使用 socket 认证，可能无需密码。
2. 创建新用户，替换占位符：
   ```
   CREATE USER '[管理员账号]'[at]'localhost' IDENTIFIED WITH mysql_native_password BY '[强密码]';
   ```
3. 授予所需权限。仅管理用途可授全部权限：
   ```
   GRANT ALL PRIVILEGES ON *.* TO '[管理员账号]'[at]'localhost' WITH GRANT OPTION;
   ```

   若只需管理特定库，改为对应库名并去掉 `WITH GRANT OPTION`。
4. 刷新权限：
   ```
   FLUSH PRIVILEGES;
   ```

### 方法二：调整 root 认证插件

1. 登录 MySQL 后查看当前插件与 host：
   ```
   SELECT user, plugin, host FROM mysql.user WHERE user = 'root';
   ```
2. 若 plugin 为 `auth_socket` 或 `caching_sha2_password`，且 host 为 `localhost` 或 `%`，可改为：
   ```
   ALTER USER 'root'[at]'localhost' IDENTIFIED WITH mysql_native_password BY '[强密码]';
   ```
3. 刷新权限：
   ```
   FLUSH PRIVILEGES;
   ```

> 注意：`caching_sha2_password` 在部分 PHP 版本下与 phpMyAdmin 兼容性不佳，是否可用需查阅对应版本官方文档。若 host 值不是 `localhost` 或 `%`，需先确认访问来源再调整。

## 验证方法

- 用新账户或 root 登录 phpMyAdmin，确认可进入并执行简单查询。
- 命令行验证：`mysql -u [管理员账号] -p -h localhost`，确认认证插件生效。
- 再次查询 `mysql.user`，确认 plugin 与 host 符合预期。
- 检查 phpMyAdmin 与 PHP 错误日志，确认无新的连接报错。

## 回退建议

- 若调整 root 插件后本机 socket 登录失效，可用系统管理员身份通过 socket 重新登录并改回原插件。
- 若新建用户引发权限问题，删除该用户：`DROP USER '[管理员账号]'[at]'localhost';`，再刷新权限。
- 必要时从备份恢复 `mysql` 系统库，恢复前停止写入并确认备份完整。

## 常见问题

- 报错依旧：确认 phpMyAdmin 配置中的主机名与 MySQL 用户 host 匹配，`localhost` 与 `[IP地址]` 可能走不同认证路径。
- 提示会话 cookie 失败：多为通过 HTTP 访问，需启用 HTTPS 或调整 phpMyAdmin 配置。
- 非 root 账户报同类错误：检查密码、host 范围与权限，必要时重置该账户密码。
- 版本差异：MySQL 5.6 及以下行为不同，具体支持范围请查阅对应版本官方文档。
