MySQL 8.0.19+才原生支持MAX_QUERIES_PER_HOUR,需用CREATE/ALTER USER WITH设置,按自然小时滚动统计成功语句,新连接生效,旧连接复用导致延迟体现,5.7及以下需代理或应用层实现。

MySQL 8.0+ 中用 CREATE USER 或 ALTER USER 设置查询限制
MySQL 原生支持基于用户的资源限制,但仅限于 MySQL 8.0.19 及以上版本(且必须使用 caching_sha2_password 或 sha256_password 认证插件)。低于该版本的 MySQL(包括 5.7)完全不支持每小时查询次数限制,强行配置会静默忽略或报错。
设置方式很简单,关键是参数名要写对:MAX_QUERIES_PER_HOUR —— 注意不是 max_queries、不是 query_limit,大小写不敏感但下划线不能错。
实操建议:
- 新建用户时直接指定:
CREATE USER 'app_user'@'%' IDENTIFIED BY 'pwd123' WITH MAX_QUERIES_PER_HOUR 300;
- 修改已有用户:
ALTER USER 'app_user'@'%' WITH MAX_QUERIES_PER_HOUR 300;
- 设为 0 表示不限制;设为正整数才生效;负数或非数字会报语法错误
- 该限制是“服务器级”的,按自然小时滚动(不是从首次登录起计时),且只统计成功执行的语句(
SELECT、INSERT、UPDATE、DELETE等),不包括SHOW、SET、DO等
为什么 FLUSH PRIVILEGES 不起作用
资源限制(如 MAX_QUERIES_PER_HOUR)存储在 mysql.user 表中,但和权限不同:它**不需要**执行 FLUSH PRIVILEGES 生效。MySQL 在用户下次认证(即新连接建立)时读取并加载这些值。
常见错误现象:
- 改完
ALTER USER后立刻用原连接测试,发现没被限——因为限制只对新连接生效 - 执行了
FLUSH PRIVILEGES却以为“刷新了限制”,其实无意义,还可能掩盖连接复用问题 - 用连接池(如 Python 的
pymysql、Java 的 HikariCP)时,旧连接长期复用,导致限制看似“延迟生效”
验证是否生效,最可靠的方式是断开重连后执行足够多查询,观察是否触发 ERROR 1226 (42000): User 'app_user' has exceeded the 'max_questions' resource (current value: 300)。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
MySQL 5.7 或更低版本怎么办
原生不支持,硬加限制只能靠外部手段。不要尝试改源码或打补丁——维护成本高、升级即失效。
更现实的做法:
- 在应用层做轻量级计数:用 Redis 记录
user:app_user:hourly_queries,带过期时间(EXPIRE ... 3600),每次查询前INCR并判断阈值 - 用代理层拦截:如 ProxySQL,配置
mysql-users表中的max_connections和自定义规则匹配SELECT语句频率(需配合stats_mysql_query_digest分析) - 数据库中间件(如 MyCat、ShardingSphere)可定制 SQL 拦截逻辑,但引入额外运维复杂度
注意:所有外部方案都无法精确到“每小时”,只能做到近似(例如每 3600 秒重置计数器),且无法防止恶意长连接持续刷查询。
容易被忽略的边界情况
限制不是万能的,几个关键点常被跳过:
-
MAX_QUERIES_PER_HOUR对存储过程内部的查询不计数——只算客户端发来的顶层语句 - 事务内的多条语句(如
BEGIN; SELECT ...; SELECT ...; COMMIT;)每条都单独计数 - 如果用户有多个 host(如
'app_user'@'192.168.1.%'和'app_user'@'localhost'),它们的限制是独立的,不是共享的 - 开启
log_bin且使用基于行的复制(RBR)时,从库不会继承主库的资源限制设置,需手动在从库上重复ALTER USER
真正上线前,务必用真实连接路径(含连接池、重试逻辑)压测一小时,别只靠单次脚本验证。

















