查不到root@localhost记录说明权限表缺项，常见于重装、升级8.0+或误删user表；需用CREATE USER+GRANT重建，指定匹配的authentication_string和plugin（如caching_sha2_password或mysql_native_password），并FLUSH PRIVILEGES。
查不到 root@localhost 记录，说明权限表缺项
这个错误最常出现在重装 MySQL、升级到 8.0+、或手动清理过 mysql.user 表之后。MySQL 实际认证时会严格匹配 User 和 Host 的组合，'root'@'localhost' 和 'root'@'127.0.0.1' 是两条完全不同的记录 —— 即使你用 mysql -u root -p -h 127.0.0.1 能登录，也不代表 localhost 可用。
直接查表确认：
SELECT Host, User, authentication_string FROM mysql.user WHERE User = 'root';
如果返回结果里没有 Host = 'localhost' 这一行，就坐实了缺项问题。常见现象是只有 'root'@'%' 或 'root'@'hostname'，但没留本地回环通路。
UPDATE 或 INSERT 补全 root@localhost 记录
补记录不能只改 Host 字段（尤其在 MySQL 8.0+），因为 authentication_string 加密方式、plugin 字段都得对齐。推荐用 CREATE USER + GRANT 组合，而不是裸 UPDATE。
- 先检查当前默认插件：
SELECT plugin FROM mysql.user WHERE User = 'root' AND Host = '127.0.0.1';（选一条已存在的记录参考） - 若插件是
caching_sha2_password（MySQL 8.0 默认），执行：CREATE USER 'root'@'localhost' IDENTIFIED WITH caching_sha2_password BY 'your_password';<br>GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' WITH GRANT OPTION;
- 若要兼容老客户端（如某些 GUI 工具），可强制切回
mysql_native_password：CREATE USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
- 最后别忘：
FLUSH PRIVILEGES;
为什么不用 UPDATE user SET Host='localhost' 直接改？
这种操作在 MySQL 5.7 及更早版本可能侥幸成功，但在 8.0+ 极易失败或引发后续认证异常，原因有三：
使用tbot机器ID身份文件配合tsh CLI，通过Teleport访问控制SSH登录托管主机或执行远程命令。
-
authentication_string字段值是加密后的哈希，直接 UPDATE 不会重新计算，导致密码失效 -
plugin字段可能为空或错配，MySQL 启动时会拒绝加载该用户 - 主键是
(User, Host)，强行 UPDATE 可能触发唯一约束冲突（比如已有'root'@'localhost'但被禁用）
真正安全的做法是删旧建新：DROP USER 'root'@'localhost'; 再 CREATE USER ...，避免残留状态干扰。
验证是否生效：别只信 mysql -u root -p
这个命令默认走 socket 连接，底层等价于 -h localhost，但部分系统会自动 fallback 到 127.0.0.1 —— 所以它“能登”不代表 localhost 记录已生效。
必须显式指定 host 并禁用 socket：
-
mysql -u root -p -h localhost --protocol=tcp（强制走 TCP，绕过 socket） -
mysql -u root -p -h 127.0.0.1（对比验证，确认两者行为差异）
如果前者报错后者成功，说明 localhost 记录仍未就位；如果都成功，再检查应用连接字符串里是否误写了 host: 127.0.0.1 却期望走 localhost 权限逻辑 —— 这类细节最容易被忽略。
