MySQL 8.0.3+ 原生支持 MAX_QUERIES_PER_HOUR 和 MAX_UPDATES_PER_HOUR,但需通过 CREATE/ALTER USER WITH 子句显式设置;低于该版本或 5.7.21 前基本无效,因服务端不校验。

MySQL 8.0.3+ 原生支持 MAX_QUERIES_PER_HOUR 和 MAX_UPDATES_PER_HOUR,但必须用 CREATE USER 或 ALTER USER 的 WITH 子句显式设置;低于 8.0.3 或 5.7.21 之前的版本,该机制基本不可靠——不是语法不认,而是服务端压根不校验。
怎么正确配置每小时查询和更新次数上限
这两个限制不是系统变量,也不是配置文件参数,只能在用户创建或修改时绑定:
- 新建用户:
CREATE USER 'api'@'%' IDENTIFIED BY 'pwd' WITH MAX_QUERIES_PER_HOUR 60 MAX_UPDATES_PER_HOUR 10; - 修改已有用户:
ALTER USER 'api'@'%' WITH MAX_QUERIES_PER_HOUR 30 MAX_UPDATES_PER_HOUR 5; - 取消限制必须设为
0:ALTER USER 'api'@'%' WITH MAX_QUERIES_PER_HOUR 0;(设成NULL或省略字段,不会清空) - 检查是否生效:
SHOW GRANTS FOR 'api'@'%';—— 输出里得出现MAX_QUERIES_PER_HOUR 30这类字样
为什么设了却完全没效果
常见失效不是因为你写错了 SQL,而是 MySQL 服务端根本没开这个检查开关:
- MySQL 5.7.6+ 默认跳过
mysql.user表里的max_questions和max_updates字段校验,即使你ALTER USER成功,SELECT 1执行 1000 次也不会报错 - MySQL 8.0+ 彻底移除了运行时资源限制逻辑,
MAX_QUERIES_PER_HOUR语法保留仅为了向前兼容,实际不生效 - 你用的是连接池(如 HikariCP),但误以为限制按连接计数——其实它是按
User+Host组合全局累计的,1 个连接狂刷 60 次SELECT就会触发,和连接数无关 - ORM 启动时的
SELECT DATABASE()、SHOW VARIABLES等隐式查询也被计入额度,可能还没跑业务就耗光了
错误日志里看不到 ERROR 1226?那就真没生效
真正生效时,超限第一下就会返回明确错误:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
ERROR 1226 (42000): User 'api'@'%' has exceeded the 'max_questions' resource (current value: 60)
- 这个错误只会在超限时出现一次,之后所有同类型语句继续失败,直到自然小时重置(从整点开始,比如 14:00–15:00)
- 注意:它不是滑动窗口,也不是“过去 60 分钟”,所以 14:59 执行第 60 次,15:00 执行第 1 次就又可以了
- 存储过程内部的
SELECT不计入调用者的MAX_QUERIES_PER_HOUR,只算最外层语句 -
SUPER权限用户完全绕过所有这类限制,检查权限用:SHOW GRANTS FOR 'api'@'%';
真要控频次,别只盯着 MySQL 服务端
原生机制在生产环境几乎不可信。可靠方案只有两个:
- 有中间件:上
ProxySQL,在mysql_query_rules里匹配用户名 +^SELECT,配合 Redis 计数器实现带 TTL 的原子增减 - 无中间件:应用层每次发查询前,执行 Redis Lua 脚本:
EVAL "local c = redis.call('INCR', KEYS[1]); redis.call('EXPIRE', KEYS[1], 3600); return c" 1 user:api:hourly_qps,返回值 >60 就拒绝 - 别碰触发器、审计插件或
UPDATE mysql.user+FLUSH PRIVILEGES这套——开销大、不原子、版本行为不一致
时间窗口对齐最容易被忽略:MySQL 的“自然小时”和你业务监控用的 UTC 或本地时区可能错位,告警阈值得按 MySQL 服务器当前时间(NOW())对齐,而不是按应用日志时间戳。










