必须用ALTER USER ... IDENTIFIED BY ... RETAIN CURRENT PASSWORD;SET PASSWORD会清空辅助密码致业务中断,不带RETAIN的ALTER USER则使旧密码长期残留;执行前须验证密码非空、主从同步完成、插件一致;DISCARD OLD PASSWORD须显式调用才能清理旧密码。

必须用 ALTER USER ... IDENTIFIED BY ... RETAIN CURRENT PASSWORD
MySQL 8.0 的双密码机制只认这一条语句,其他任何方式都会破坏旧密码有效性。用 SET PASSWORD 会直接清空辅助密码,导致旧凭据立即失效;用不带 RETAIN CURRENT PASSWORD 的 ALTER USER 则只更新主密码,把旧密码“锁死”在 mysql.user 表里长期有效——审计时能用半年前的密码登录,大概率就是这里漏了。
常见错误现象:
- 执行
SET PASSWORD FOR 'u'@'h' = 'new'后,部分应用连接随机断开(取决于从库同步状态) - 混写
SET PASSWORD ... RETAIN CURRENT PASSWORD直接报错ERROR 1064 (42000) - 误删
RETAIN CURRENT PASSWORD关键字,语句虽执行成功,但双密码实际未生效
执行前必须验证三件事
这条语句前置检查极严,漏一项就失败,不是语法错,而是运行时报 ERROR 3031 或 ERROR 3894:
-
authentication_string字段不能为NULL或空字符串(即账户必须已有有效密码) - 只能在主库执行,且需确认所有从库
Seconds_Behind_Master = 0后再切流量 - 语句中不能同时指定
IDENTIFIED WITH插件变更,否则触发ERROR 3894
验证方法:连上主库后先查 SELECT User, Host, plugin, authentication_string FROM mysql.user WHERE User = 'u';,确保字段非空、插件一致、无从库延迟。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
DISCARD OLD PASSWORD 不是自动的,得手动清理
双密码不会随改密次数增加而过期,只要没显式执行 DISCARD OLD PASSWORD,最早那次被 RETAIN CURRENT PASSWORD 保留下来的密码就一直有效。它不接受参数,也不支持批量操作,每个账户都得单独执行:
ALTER USER 'u'@'h' DISCARD OLD PASSWORD;
容易忽略的点:
- 执行后无法撤销,旧密码永久失效 “双密码状态”完全靠
mysql.user 表里的元数据标记(如 password_last_changed、password_reuse_interval 等字段组合),而不是看哈希值数量——你查不到“两个密码”,只能靠行为验证:新旧密码都能连上,才算真生效
轮转节奏与生产切换建议
不要等密码快过期才轮转。建议按固定周期(如每90天)执行一次双密码流程,并预留至少7天重叠窗口供应用灰度切换:
- 第1天:执行
ALTER USER ... IDENTIFIED BY 'new' RETAIN CURRENT PASSWORD - 第2–7天:监控连接日志,确认新旧密码均能通过认证,且无
Access denied报错 - 第8天:执行
ALTER USER ... DISCARD OLD PASSWORD
最危险的操作是跳过验证直接丢旧密码——一旦新密码配置有误或应用未同步更新,服务就会中断。双密码不是“多一个密码”,而是“多一个逃生通道”,通道建好了,得真走一遍才放心。

















