消息队列 / 系统课时
仲裁队列投递限制
仲裁队列投递限制
反复失败并重新入队的消息会形成“毒性消息”循环,占用消费者、磁盘日志和网络资源。RabbitMQ 4.3 的仲裁队列可以用 delivery limit 限制失败投递次数,并在越限后丢弃或转入死信链路;关键是分清哪些返回动作会增加失败计数。
学习目标
- 理解
x-delivery-count与 delivery limit 的关系 - 使用 policy 为仲裁队列配置投递上限和死信交换机
- 避免把普通
basic.nack重新入队误认为一定会消耗投递次数
投递限制如何阻止毒性消息
仲裁队列会跟踪失败投递次数,并在重新投递时通过 x-delivery-count 暴露该计数。RabbitMQ 4.0 起默认 delivery limit 为 20;当计数超过限制后,如果配置了 dead letter exchange,消息会进入死信链路,否则会被删除。
RabbitMQ 4.3 把“被消费者取得过多少次”和“真正失败了多少次”区分开来:x-acquired-count 记录取得次数,x-delivery-count 只记录被认定为失败的投递。delivery limit 依据后者判断,因此“重新入队”不再天然等于“失败次数加一”。

用 policy 配置上限与死信去向
生产环境更适合用 policy 配置 delivery-limit,因为它可以应用到已存在的仲裁队列并集中维护。下面把名称为 orders.qq 的仲裁队列上限设为 5,并把越限消息发送到 orders.dlx,路由键使用 orders.poison。示例假设死信交换机及其目标队列已经创建并正确绑定。
rabbitmqctl set_policy qq-poison '^orders\.qq$' '{"delivery-limit":5,"dead-letter-exchange":"orders.dlx","dead-letter-routing-key":"orders.poison"}' --priority 100 --apply-to quorum_queues
rabbitmqctl list_policies name pattern apply_to definition预期输出
Listing policies for vhost "/" ...
qq-poison ^orders\.qq$ quorum_queues {"dead-letter-exchange":"orders.dlx","dead-letter-routing-key":"orders.poison","delivery-limit":5}字段顺序可能因 CLI 版本而不同,但应能看到 qq-poison、quorum_queues、delivery-limit 为 5,以及对应的死信交换机。policy 只决定越限后的路由规则,orders.dlx 和它绑定的目标队列必须实际存在,否则消息无法按预期落入毒性消息队列。
RabbitMQ 4.3 的计数边界
在 4.3 中,basic.nack 触发的普通返回不会增加 delivery-count;连接或会话在存在未确认消息时异常终止,以及被 RabbitMQ 认定为真实失败的投递,会增加失败计数。basic.reject 也会被计入失败投递。
这意味着应用如果始终使用 basic.nack(..., requeue=true) 做立即重试,不能指望 delivery limit 自动终止这个循环。对于可恢复的短暂故障,更合理的是使用带退避的延迟重试;对于明确不可处理的消息,则应拒绝并进入受控的死信或隔离流程。
验证毒性消息是否被隔离
验证时准备一条固定会失败的测试消息,让消费者按你的实际失败策略处理,并观察重新投递消息的 x-delivery-count。当失败计数超过配置值后,原队列中不应再持续看到该消息;配置了 DLX 时,应能在毒性消息目标队列中找到它。
验收重点不是“消费者报了 5 次错”,而是实际失败计数、越限动作和死信落点都符合设计。RabbitMQ 4.3 对返回与失败进行了更细的区分,因此重试策略、ACK/NACK/Reject 语义和 delivery limit 必须一起设计,才能真正阻断毒性消息循环。