MySQL 5.7 用户认证插件异常(如 auth_socket)会导致无法设密码或客户端连接失败,需通过 ALTER USER 或 UPDATE mysql.user 修改 plugin 为 mysql_native_password 并同步更新 authentication_string,且必须匹配精确 host(如 'localhost' 与 '127.0.0.1' 不同),最后执行 FLUSH PRIVILEGES。

MySQL 5.7 默认用 mysql_native_password,但如果你的用户被意外设为 auth_socket(比如 Ubuntu 系统预装版本),或者从其他环境迁移过来用了非默认插件,就会出现“能登录但设不了密码”“客户端连不上”这类问题。改回 mysql_native_password 是必要且安全的操作,关键在步骤顺序和 host 匹配。
确认当前用户的 plugin 值是否异常
不猜、不假设,先查真实状态。尤其注意 host 字段——'root'@'localhost' 和 'root'@'%' 是两个完全不同的用户记录。
- 登录 MySQL(可用无密码方式):
sudo mysql -u root - 执行查询:
SELECT user, host, plugin FROM mysql.user WHERE user = 'root'; - 如果结果中
plugin是auth_socket或unix_socket,就需修改;如果是mysql_native_password却仍连不上,问题大概率出在客户端驱动或连接参数上
用 ALTER USER 修改插件并设密码(推荐方式)
这是 MySQL 5.7+ 官方推荐方式,原子性强,不会漏掉密码更新。注意:必须显式指定 host,且不能省略 BY 子句——即使你只想改插件不改密码,也得带上原密码(否则密码会被清空)。
- 语法必须完整:
ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_new_password'; - 如果你不确定原密码,或想重置,就填新密码;如果只是修复插件,就把原密码填进去
- 执行后立刻跟一句:
FLUSH PRIVILEGES;—— 不要等重启,很多场景下重启根本不会刷新已加载的权限缓存
UPDATE mysql.user 手动改表(仅当 ALTER USER 失败时备用)
极少数情况下(如权限被锁死、SQL_MODE 限制严格),ALTER USER 会报错。这时可直写 mysql.user 表,但风险更高,务必小心字段名和函数调用。
UPDATE mysql.user SET plugin = 'mysql_native_password', authentication_string = PASSWORD('your_new_password') WHERE user = 'root' AND host = 'localhost';- 注意:
PASSWORD()函数在 MySQL 8.0 已废弃,但在 5.7 中仍有效;别误用成SHA2()或裸字符串 - 改完必须执行:
FLUSH PRIVILEGES;,否则修改不生效 - 不要只改
plugin不改authentication_string,否则可能变成“空密码 + 正确插件”,依然不安全
最容易被忽略的是 host 匹配粒度——'root'@'127.0.0.1' 和 'root'@'localhost' 在 MySQL 里是两条独立记录,Unix socket 登录走的是后者,TCP 连接走的是前者。改完一个,记得检查另一个。



















