MySQL 8.0 不支持自动轮换,双密码平滑切换必须依赖外部调度+两条 ALTER USER 语句:先 RETAIN CURRENT PASSWORD 启用新旧共存,再 DISCARD OLD PASSWORD 清理旧密码;SET PASSWORD 不参与该机制,仅覆盖主密码并清空辅助密码,必然导致认证失败。

MySQL 8.0 本身不提供“自动轮换”能力,双密码平滑轮换必须靠外部调度 + 两个明确 SQL 操作完成:先用 ALTER USER ... RETAIN CURRENT PASSWORD 启用新旧共存,再用 ALTER USER ... DISCARD OLD PASSWORD 清理旧密码。中间没有自动机制,漏掉任一环节或顺序错乱,业务就会中断。
为什么不能用 SET PASSWORD 实现双密码
SET PASSWORD 在 MySQL 8.0 中完全不参与双密码状态机。它只会覆盖主密码,并无条件清空辅助密码(如果存在)。这不是“不推荐”,而是语义上就不支持——执行后旧密码立刻失效,连接池重连失败、应用报 Access denied 是必然结果。
- 常见错误现象:
SET PASSWORD FOR 'u'@'h' = 'new'执行后,所有还在用旧密码的活跃连接仍能维持,但下次认证(如连接池重建)全部失败 - 语法混淆陷阱:文档里若出现
SET PASSWORD ... RETAIN CURRENT PASSWORD,纯属笔误,MySQL 解析器会直接报ERROR 1064 (42000) - 根本原因:双密码依赖账户元数据中的
password_reuse_history字段和认证插件内部标记,只有ALTER USER的RETAIN CURRENT PASSWORD子句才会触发该状态变更
ALTER USER ... RETAIN CURRENT PASSWORD 的前置校验清单
这条语句看似一行 SQL,但失败率极高,绝大多数报错都源于未满足三个硬性前提:
- 当前账户密码不能为空:
SELECT authentication_string FROM mysql.user WHERE user = 'u' AND host = 'h'返回值不能是NULL或空字符串;否则报ERROR 3031 (HY000): Cannot retain current password for account with empty password - 不能在从库上直接执行:必须在主库执行,且需等所有从库复制完成(
Seconds_Behind_Master = 0),否则部分节点只认新密码、部分只认旧密码,应用随机报错 - 认证插件不能变更:执行时若同时指定
IDENTIFIED WITH caching_sha2_password(或任何不同于当前插件的值),会报ERROR 3894 (HY000): Current password cannot be retained because authentication plugin is being changed
如何模拟“自动轮换”:三步外部编排
真正的自动化必须由外部调度器驱动(如 cron、K8s CronJob),并嵌入状态检查逻辑,MySQL 只负责提供安全切换能力:
- 第一步:定时触发双密码切换,例如:
mysql -u root -e "ALTER USER 'app'@'%' IDENTIFIED BY 'new_202608' RETAIN CURRENT PASSWORD" - 第二步:宽限期等待与验证,至少 24 小时,期间需确认应用已全部迁移到新密码——MySQL 不暴露“本次连接用的是哪个密码”,只能靠应用侧日志、连接池配置更新时间、或
performance_schema.threads中的USER字段做间接推断 - 第三步:执行清理:
ALTER USER 'app'@'%' DISCARD OLD PASSWORD;若发现仍有旧密码连接残留,必须中止并告警——因为DISCARD OLD PASSWORD是不可逆操作,且不会自动发生
最易被忽略的点:双密码不会自动过期,哪怕你改了十次密码,只要没显式执行 DISCARD OLD PASSWORD,最早那次被 RETAIN CURRENT PASSWORD 保留下来的密码就一直有效。安全审计时发现半年前的密码还能登录,不是漏洞,是你忘了清理。


















