MySQL 8.0+中启用首次登录强制改密的唯一有效方式是执行ALTER USER 'user'@'host' PASSWORD EXPIRE IMMEDIATE;,该操作将password_expired设为'Y',用户登录后首次执行非SET语句(如SELECT 1)即触发ERROR 1820,必须用ALTER USER IDENTIFIED BY重置密码。

MySQL 8.0+ 中如何启用密码过期强制修改
MySQL 8.0 开始原生支持密码过期策略,但「首次登录强制修改密码」不是开箱即用的功能——它需要组合使用 ALTER USER ... PASSWORD EXPIRE 和客户端行为配合。服务端本身不拦截首次登录并弹出修改提示,而是通过让密码立即过期,使后续任何操作(包括 SELECT 1)都触发错误,倒逼用户主动执行 ALTER USER ... IDENTIFIED BY。
- 仅适用于 MySQL 8.0 及以上版本(5.7 不支持
PASSWORD EXPIRE) - 必须确保客户端支持处理
ER_MUST_CHANGE_PASSWORD错误(如 MySQL Shell、mysql CLI 8.0+、部分 JDBC 驱动 8.0.19+);老版本 mysql 命令行会直接报错退出,无法继续输入修改语句 - 创建用户时不能用
CREATE USER ... IDENTIFIED BY后立刻PASSWORD EXPIRE,而应分两步:先建用户(可设初始密码),再显式过期
正确配置首次登录强制改密的完整步骤
以新建用户 dev_user 为例,目标是:该用户首次用密码登录后,任何 SQL 执行都会失败,并提示需先改密。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
CREATE USER 'dev_user'@'%' IDENTIFIED BY 'TempPass123!'; ALTER USER 'dev_user'@'%' PASSWORD EXPIRE IMMEDIATE;
-
PASSWORD EXPIRE IMMEDIATE是关键:它让密码在创建后立即过期,而非设置一个未来时间点 - 不要用
PASSWORD EXPIRE DEFAULT或PASSWORD EXPIRE INTERVAL 90 DAY,它们不会触发首次登录强改逻辑 - 如果用户已存在,直接执行
ALTER USER ... PASSWORD EXPIRE IMMEDIATE即可生效,无需重置密码 - 注意主机名匹配:若应用连接的是
dev_user@localhost,但你对dev_user@'%'执行了过期,则无效
用户登录后实际遇到的错误与应对方式
用户用 mysql CLI 登录后,只要执行任意非 SET 语句(比如 SELECT DATABASE()),就会收到:
ERROR 1820 (HY000): You must reset your password using ALTER USER statement before executing this statement.
- 此时唯一合法操作是
ALTER USER USER() IDENTIFIED BY 'NewPass456!';(推荐用USER()避免写死用户名) - 不能用
SET PASSWORD,MySQL 8.0+ 已弃用该语法,且不被过期机制识别 - 某些 ORM 或连接池(如 HikariCP)可能自动执行探测 SQL(如
SELECT 1),导致连接初始化失败;需在连接字符串中加allowPublicKeyRetrieval=true&useSSL=false并确保驱动版本兼容,或提前为该用户完成密码重置
为什么 Navicat / Workbench 登录后没提示改密?
图形化工具往往在连接建立后静默执行多条系统查询(如获取表列表、字符集等),其中某一条触发了过期错误,但界面未明确展示原始错误码,只显示「连接中断」或「认证失败」。
- 解决方法:先用命令行 mysql 登录,手动执行改密语句,再换回图形工具
- Workbench 8.0.22+ 支持在连接配置中勾选「Prompt for password on connect」并配合过期用户,但依然依赖底层驱动响应
ER_MUST_CHANGE_PASSWORD - Navicat 16+ 在连接测试阶段会捕获该错误并弹窗提示,但旧版会静默失败——建议升级客户端或改用 MySQL Shell 进行首次初始化
ER_MUST_CHANGE_PASSWORD,这个机制就形同虚设。

















