参考来源与致谢
- 引用来源:Can't log into phpMyAdmin: mysqli_real_connect(): (HY000/1698): Access denied for user 'root'[at]'localhost' – DevAnswers.co
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
通过 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 创建专用超级用户(推荐) #
- 以系统管理员身份登录 MySQL:
sudo mysql -u root -p若 root 使用 socket 认证,可能无需密码。
- 创建新用户,替换占位符:
CREATE USER '[管理员账号]'[at]'localhost' IDENTIFIED WITH mysql_native_password BY '[强密码]'; - 授予所需权限。仅管理用途可授全部权限:
GRANT ALL PRIVILEGES ON *.* TO '[管理员账号]'[at]'localhost' WITH GRANT OPTION;若只需管理特定库,改为对应库名并去掉
WITH GRANT OPTION。 - 刷新权限:
FLUSH PRIVILEGES;
方法二:调整 root 认证插件 #
- 登录 MySQL 后查看当前插件与 host:
SELECT user, plugin, host FROM mysql.user WHERE user = 'root'; - 若 plugin 为
auth_socket或caching_sha2_password,且 host 为localhost或%,可改为:ALTER USER 'root'[at]'localhost' IDENTIFIED WITH mysql_native_password BY '[强密码]'; - 刷新权限:
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 及以下行为不同,具体支持范围请查阅对应版本官方文档。
