MySQL 8.0+ 原生不支持真正的“每小时查询次数”动态窗口限流,MAX_QUERIES_PER_HOUR 是累计计数、整点重置的近似方案,实际需应用层(如Redis)或中间件(如ProxySQL)实现精确滑动窗口限流。

MySQL 8.0+ 中用 CREATE USER 配合 MAX_QUERIES_PER_HOUR 限制查询频次
MySQL 原生支持基于账号的资源限流,但仅适用于 MySQL 8.0 及以上版本(5.7 不支持该参数)。限制生效对象是「该账号通过任意客户端、任意 IP 连接时的总查询数」,不是单个连接或某条 SQL 的频率。
实操时需注意:该限制统计的是 SELECT 语句数量(不含 SHOW、SET、DO 等),且计时窗口为严格每小时滚动(非滑动窗口),从账号首次执行查询起算第一小时,之后整点对齐。
- 创建新账号并设限:
CREATE USER 'reporter'@'%' IDENTIFIED BY 'pwd123';<br>ALTER USER 'reporter'@'%' WITH MAX_QUERIES_PER_HOUR 300;
- 修改已有账号:
ALTER USER 'api_user'@'10.20.%' WITH MAX_QUERIES_PER_HOUR 120;
- 查看当前账号限制:
SELECT user, host, max_questions FROM mysql.user WHERE user = 'reporter';
为什么 MAX_QUERIES_PER_HOUR 在某些场景下“没生效”
常见误判源于未刷新权限或混淆了「查询」定义。MySQL 不把 INSERT/UPDATE/DELETE 计入该配额,只统计 SELECT;同时,该限制在内存中维护,依赖 FLUSH PRIVILEGES 后才对新连接生效(已存在的连接不重载)。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 执行
ALTER USER后必须运行FLUSH PRIVILEGES,否则新连接可能沿用旧配额 -
SHOW PROCESSLIST或SELECT @@version不消耗配额,但SELECT COUNT(*) FROM information_schema.tables会 - 如果账号有多个
host条目(如'user'@'192.168.%'和'user'@'%'),MySQL 按匹配精度最高者应用限制,不会叠加
MySQL 5.7 或更低版本如何变通实现类似效果
5.7 不支持 MAX_QUERIES_PER_HOUR,只能靠外部手段兜底。最实用的是在应用层加查询计数器(如 Redis + Lua 原子操作),或用代理层(ProxySQL)做规则拦截。
- ProxySQL 示例规则(匹配 SELECT 开头语句,每小时最多 300 次):
INSERT INTO mysql_query_rules (active, match_digest, destination_hostgroup, apply, sticky_conn) VALUES (1, '^SELECT', 10, 1, 1);<br>LOAD MYSQL QUERY RULES TO RUNTIME;
- 避免用触发器或存储过程模拟——它们无法跨连接共享状态,且性能开销大
- 不要依赖慢日志+定时脚本轮询——延迟高、无法实时拒绝超限请求
限制被触发后客户端收到的错误和行为
当账号在一小时内执行的 SELECT 超过设定值,后续查询会立即失败,返回错误:ERROR 1226 (42000): User 'xxx' has exceeded the 'max_questions' resource (current value: N)。此时连接仍保持活跃,但所有新 SELECT 都被拒,其他语句(如 INSERT)不受影响。
- 错误不可捕获重试——MySQL 服务端直接中断语句执行,应用需处理该错误码并降级或告警
- 计数器在整点自动清零(例如 14:00–14:59 的查询数,到 15:00:00 归零),不因连接断开而重置
- 若账号同时设置了
MAX_UPDATES_PER_HOUR等其他限制,它们独立计数、互不影响
FLUSH PRIVILEGES,或者误以为“刚连上就重新计时”,结果测试时发现阈值好像没起作用。

















