MySQL 8.0双密码仅在ALTER USER ... RETAIN CURRENT PASSWORD成功执行后建立,需满足账户有非空密码、插件为caching_sha2_password、版本≥8.0.14;否则报ERROR 3031或3894,且SET PASSWORD会立即清空辅助密码,DISCARD OLD PASSWORD必须显式执行。

MySQL 8.0 的双密码不是“配出来就自动轮换”的功能,它只在 ALTER USER ... IDENTIFIED BY ... RETAIN CURRENT PASSWORD 成功执行后才存在,且必须满足三个硬性前提:账户已有非空密码、认证插件为 caching_sha2_password、MySQL 版本 ≥ 8.0.14。
为什么 ALTER USER ... RETAIN CURRENT PASSWORD 总是报 ERROR 3031 或 ERROR 3894
这两个错误不是语法写错,而是账户状态不达标:
-
ERROR 3031 (HY000):账户当前authentication_string为空或 NULL,常见于刚CREATE USER但没设密码,或被SET PASSWORD清过密码。解决办法:先用ALTER USER 'u'@'h' IDENTIFIED BY 'old'设一个有效主密码,再执行带RETAIN CURRENT PASSWORD的语句 -
ERROR 3894 (HY000):语句中混用了IDENTIFIED WITH,例如ALTER USER 'u'@'h' IDENTIFIED WITH caching_sha2_password BY 'new' RETAIN CURRENT PASSWORD。双密码只允许在同一插件下切换,不能借改密顺便换插件 - 从库上执行也会失败,且不提示“请在主库执行”,而是静默拒绝。必须先确认
SHOW SLAVE STATUS\G中Seconds_Behind_Master = 0
SET PASSWORD 会立刻清空辅助密码
SET PASSWORD 是 MySQL 5.7 时代的遗留语法,在 8.0 中仅用于兼容。它和双密码机制完全无关:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 执行
SET PASSWORD FOR 'u'@'h' = 'new'后,旧密码立即失效,辅助密码被清空 - 哪怕前一秒刚用
RETAIN CURRENT PASSWORD建好双密码,这一条SET PASSWORD就让辅助密码消失 - 脚本里混用两者,MySQL 直接报
ERROR 1064 (42000)语法错误——它们根本不能共存
如何验证双密码是否真生效
不能只看语句执行成功,必须做三件事验证:
- 分别用新密码和旧密码各连一次:
mysql -u u -p'old' -h host和mysql -u u -p'new' -h host,都应成功返回mysql> - 查
mysql.user表:SELECT user, host, authentication_string FROM mysql.user WHERE user = 'u' AND host = 'h',authentication_string字段值应仍是旧密码的哈希(说明旧密码被保留为辅助密码) - 执行
DISCARD OLD PASSWORD必须显式调用才能清理辅助密码;它不会自动过期,也不会被后续的ALTER USER覆盖——跳过这步直接删用户重建,权限、资源限制、SSL 设置等需全部重配
最容易被忽略的是:双密码不是“改一次就自动轮换”,而是靠人工控制生命周期。主密码和辅助密码长期并存,直到你显式执行 DISCARD OLD PASSWORD。漏掉这一步,最老那次被保留下来的密码仍有效,可能成为安全盲区。










