在MySQL数据库的日常运维中，为了防止单个用户发起过多查询请求导致数据库负载过高，影响其他业务的正常使用，我们可以通过MAX_QUERIES_PER_HOUR参数来限制用户每小时的查询次数上限，这是用户资源使用管控的重要组成部分。
MAX_QUERIES_PER_HOUR的作用说明
MAX_QUERIES_PER_HOUR是MySQL用户权限体系中的一个资源限制参数，用于规定某个数据库用户在一小时内最多可以执行多少次查询操作。当该用户在一小时内的查询次数达到设定的上限后，后续发起的查询请求会被数据库直接拒绝，直到进入下一个小时周期才会重新计数。
除了MAX_QUERIES_PER_HOUR之外，MySQL还支持其他几个类似的资源限制参数，具体差异如下：
| 参数名称 | 限制内容 | 适用场景 |
|---|---|---|
| MAX_QUERIES_PER_HOUR | 每小时查询次数上限 | 管控查询类请求的频率 |
| MAX_UPDATES_PER_HOUR | 每小时更新次数上限 | 管控写操作的频率 |
| MAX_CONNECTIONS_PER_HOUR | 每小时连接次数上限 | 防止频繁建立连接消耗资源 |
| MAX_USER_CONNECTIONS | 最大并发连接数上限 | 限制同时连接的会话数量 |
配置MAX_QUERIES_PER_HOUR的前提条件
要生效用户资源限制配置，需要满足以下两个前提：
- 当前登录的数据库账号需要有GRANT OPTION权限，否则无法修改其他用户的资源限制参数。
- MySQL的系统变量
max_user_connections没有设置为0，同时资源限制功能没有被全局禁用。
配置MAX_QUERIES_PER_HOUR的具体方法
方式一：创建新用户时直接配置
如果是新建用户，可以在创建用户的同时指定MAX_QUERIES_PER_HOUR的数值，语法如下：
-- 创建用户test_user，密码为test_pass，限制每小时最多查询100次 CREATE USER 'test_user'@'localhost' IDENTIFIED BY 'test_pass' WITH MAX_QUERIES_PER_HOUR 100;
方式二：修改已有用户的资源限制
如果是对已经存在的用户调整查询频率限制，可以使用ALTER USER语句来修改，示例如下：
-- 将已存在的用户test_user的每小时查询上限调整为200 ALTER USER 'test_user'@'localhost' WITH MAX_QUERIES_PER_HOUR 200;
如果需要同时配置多个资源限制参数，可以在WITH后面并列写入多个参数，示例如下：
-- 同时配置查询、更新、连接次数限制 ALTER USER 'test_user'@'localhost' WITH MAX_QUERIES_PER_HOUR 200 MAX_UPDATES_PER_HOUR 50 MAX_CONNECTIONS_PER_HOUR 30;
方式三：通过授权语句配置
在给用户授予数据库权限的时候，也可以同步设置MAX_QUERIES_PER_HOUR参数，示例如下：
-- 授予test_user访问test_db数据库的权限，同时设置每小时查询上限为150 GRANT SELECT, INSERT ON test_db.* TO 'test_user'@'localhost' WITH MAX_QUERIES_PER_HOUR 150;
配置验证与效果查看
配置完成后，我们可以通过查询MySQL的系统表来确认参数是否生效，查询语句如下：
-- 查询用户test_user的资源限制配置 SELECT user, host, max_questions FROM mysql.user WHERE user = 'test_user' AND host = 'localhost';
其中max_questions字段对应的数值就是MAX_QUERIES_PER_HOUR的设置值，如果显示为0则表示没有限制。
如果要验证限制是否实际生效，可以用test_user账号登录数据库，在一小时内执行超过设定次数的查询，当达到上限后，执行查询会收到类似以下的错误提示：
ERROR 1226 (42000): User 'test_user' has exceeded the 'max_questions' resource (current value: 100)
常见问题与注意事项
- 如果设置MAX_QUERIES_PER_HOUR为0，表示不限制该用户的每小时查询次数。
- 资源限制的计数周期是滚动小时，不是自然小时，即从第一次查询开始计算一小时内的情况。
- 只有查询类操作会计入MAX_QUERIES_PER_HOUR的计数，更新、插入、删除等操作不计入该参数的统计。
- 如果要取消已经设置的查询频率限制，可以将参数值修改为0，执行对应的ALTER USER语句即可。
取消资源限制的方法
如果需要移除用户的查询频率限制，只需要将MAX_QUERIES_PER_HOUR设置为0即可，示例如下：
-- 取消test_user的每小时查询次数限制 ALTER USER 'test_user'@'localhost' WITH MAX_QUERIES_PER_HOUR 0;
MAX_QUERIES_PER_HOURMySQL用户资源限制查询频率配置用户权限管理修改时间：2026-06-12 07:51:24