必须用 ALTER USER 显式设置 MAX_USER_CONNECTIONS,SET GLOBAL 等方式对已有用户无效;ALTER USER 语法需严格匹配 User@Host,设为 0 表示不限制,修改后立即生效,须查 mysql.user 表和 performance_schema.threads 验证,并确保连接池配置 ≤ 该限制。

必须用 ALTER USER 显式设置 MAX_USER_CONNECTIONS,其他方式(SET GLOBAL、GRANT 单独使用、CREATE USER 漏写 WITH)对已有用户完全无效。
为什么 SET GLOBAL max_user_connections 不起作用
这个命令只影响后续新建用户的默认值,不会修改任何现存账号的限制。执行后查 mysql.user 表,目标用户的 max_user_connections 字段仍是 NULL 或旧值。线上压测时突然爆出 ERROR 1226,往往就是误信了这个“全局设置”。SHOW VARIABLES LIKE 'max_user_connections' 返回的值只是新用户的模板,和具体账号无关。
正确设置并立即生效的语法和要点
对已有用户,唯一有效语法是:
ALTER USER 'app_user'@'%' WITH MAX_USER_CONNECTIONS 5;
关键细节:
-
User@Host必须和SHOW GRANTS FOR 'app_user'@'%'输出完全一致;'app_user'@'localhost'和'app_user'@'127.0.0.1'是两个独立账号,需分别执行 - 设为
0表示不限制(退回到全局max_connections约束),不是禁止登录 - 设为
1就真只允许 1 个活跃连接,第 2 次新建连接会立刻报错:ERROR 1226 (42000) - 修改后立即生效,无需
FLUSH PRIVILEGES,也不重启 MySQL
验证是否真生效:查表 + 实测缺一不可
别信命令没报错就以为成功。唯一可信路径是两步:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
查配置:SELECT User, Host, max_user_connections FROM mysql.user WHERE User = 'app_user';——返回值必须是你设的数字,不能是 NULL 或 0(除非你本意就是不限制)
查实时连接(需开启 performance_schema):SELECT user, COUNT(*) FROM performance_schema.threads WHERE TYPE = 'FOREGROUND' AND user = 'app_user';
实测触发:开多个终端,并发执行 mysql -u app_user -p -e "SELECT 1;",第 N+1 次(N 是你设的上限)应明确报错 ERROR 1226
连接池配置必须 ≤ 用户限制值
这是最容易被忽略的落地环节。HikariCP 的 maximumPoolSize、Druid 的 maxActive 等参数,必须 ≤ 对应账号的 MAX_USER_CONNECTIONS 值。否则应用启动或首次压测就会失败,错误日志反复出现 ERROR 1226。连接池默认维持 idle 连接,哪怕业务流量为零,也会立刻占满配额。多个微服务共用同一账号(如 'app'@'%')时,总连接数会叠加突破限制——建议按实例拆分账号。

















