消息队列 / 系统课时
队列长度限制
队列长度限制
当生产速度长期高于消费速度时,队列会持续占用磁盘与内存。队列长度限制的目标不是让消息“更快消费”,而是给积压设置硬边界,并明确达到边界后是淘汰旧消息还是拒绝新发布。
学习目标
- 区分
max-length与max-length-bytes的限制对象 - 使用 Policy 为队列设置长度与字节上限
- 根据可靠性要求选择
drop-head、reject-publish或reject-publish-dlx
限制的是 Ready 消息
RabbitMQ 可以同时限制队列中的消息条数和消息体总字节数。max-length 约束 Ready 状态的消息数量,max-length-bytes 约束这些消息体的总大小;消息属性和协议开销不计入字节限制,已经投递给消费者但尚未确认的 Unacked 消息也不计入长度限制。
两个限制可以同时存在,先达到哪个就先触发溢出策略。如果同一个限制既通过 Policy 又通过队列声明参数配置,RabbitMQ 使用两者中更小的值,因此不要只看应用代码中的 x-max-length 就判断最终上限。

用 Policy 设置双重上限
生产环境更适合用 Policy 管理这类运行时约束,因为策略可以集中调整,不必把长度参数硬编码在所有生产者中。下面把 orders.buffer 的 Ready 消息限制为最多 1000 条或 10 MiB,并在达到任一上限后拒绝新发布。
# 用 Policy 同时设置条数、字节数与溢出行为
rabbitmqctl set_policy queue-cap '^orders\.buffer$' \
'{"max-length":1000,"max-length-bytes":10485760,"overflow":"reject-publish"}' \
--apply-to queues \
--priority 10
# 核对策略与运行时 Ready 指标
rabbitmqctl list_policies --formatter=pretty_table --silent
rabbitmqctl list_queues name messages_ready message_bytes_ready policy --formatter=pretty_table --silent预期结果
策略 queue-cap 匹配 orders.buffer,definition 中包含 max-length=1000、max-length-bytes=10485760 和 overflow=reject-publish。
orders.buffer 的 messages_ready 与 message_bytes_ready 会随实时流量变化;达到任一有效上限后,新发布将按 reject-publish 处理。这里的 10 MiB 是消息体总量上限,不代表 RabbitMQ 进程只会为该队列占用 10 MiB 内存。索引、元数据、未确认消息和其他运行时开销仍需单独纳入容量规划。
选择溢出策略
| 策略 | 达到上限后的行为 | 适合场景 |
|---|---|---|
drop-head |
默认行为,移除队头最旧消息;配置 DLX 时可将被淘汰消息死信 | 更重视最新数据、允许丢弃旧积压 |
reject-publish |
拒绝最新发布;启用 Publisher Confirms 时生产者收到 basic.nack |
不允许静默淘汰旧消息,希望生产端感知背压 |
reject-publish-dlx |
拒绝最新发布,并尝试将被拒消息死信 | Classic Queue 中希望保留被拒新消息 |
如果一条消息同时路由到多个队列,其中一个队列因 reject-publish 拒绝,而其他队列仍能接收,开启 Publisher Confirms 的发布者会收到 basic.nack,但消息仍可能已经进入其他目标队列。业务如果要求“所有目标队列要么都成功、要么都失败”,不能把一次 Confirm 当成跨队列事务。
验证限制是否真的生效
观察 messages_ready 和 message_bytes_ready 时,应同时查看消费者的 Unacked 数量与生产者 Confirm。前者解释为什么“队列总消息很多但长度限制没触发”,后者则确认达到上限时生产者是否真正感知了拒绝。
真正可控的队列上限由“计数口径、有效 Policy、队列类型和 overflow 策略”共同决定。配置完上限后一定要用实际发布流量做一次压测验证,确认系统在边界处采取的是你预期的淘汰或拒绝行为。