消息队列 / 系统课时

哪些消息会进入死信流程

哪些消息会进入死信流程

RabbitMQ 的“死信”不是一种特殊消息类型,而是消息在源队列中遇到特定条件后,被重新发布到配置好的 Dead Letter Exchange。理解触发条件和去向,能避免把“消息过期”“拒绝消息”和“队列溢出”误认为同一种故障。

学习目标

  • 识别 RabbitMQ 中常见的死信触发条件
  • 理解源队列、Dead Letter Exchange 与死信队列之间的关系
  • 区分“进入死信流程”和“最终一定进入某个死信队列”

常见的死信触发条件

消息从队列中变成 dead-lettered,常见有四类原因:消费者使用 basic.reject 或 basic.nack 且 requeue=false;消息达到 TTL 并在队列中被判定为过期;队列超过长度限制后,旧消息被移除或使用可死信的溢出策略;Quorum Queue 中消息超过配置的 delivery limit。

其中有两个容易混淆的边界。第一,requeue=true 会把消息重新放回可投递状态,不会因为这次拒绝直接进入死信流程。第二,整个队列过期并被删除,并不等于其中的消息逐条被死信转发。

RabbitMQ 死信触发条件与路由流程

进入死信流程还需要 DLX 配置

触发条件只说明消息应该被 dead-lettered。要让它真正流向可消费的死信队列,源队列还必须配置 Dead Letter Exchange,并保证该交换机存在可匹配的绑定。否则消息不会凭空生成一个名为“dead-letter”的队列。

下面示例使用 rabbitmqctl 为名为 work.q 的队列配置 DLX 和 5 秒消息 TTL。这里假设交换机 demo.dlx 已经创建,并且已经绑定了接收死信的队列。

bash
rabbitmqctl set_policy dead-letter-demo '^work\.q$' '{"dead-letter-exchange":"demo.dlx","dead-letter-routing-key":"dead","message-ttl":5000}' --apply-to queues
rabbitmqctl list_policies

预期结果中的表格格式可能因 RabbitMQ 版本不同而变化,但关键字段应包含策略名、匹配表达式和三项定义。

text
<...> dead-letter-demo <...> ^work\.q$ <...> dead-letter-exchange=demo.dlx <...> dead-letter-routing-key=dead <...> message-ttl=5000 <...>

message-ttl 让消息在源队列中超过 5000 毫秒后具备过期条件;dead-letter-exchange 指定重新发布的交换机;dead-letter-routing-key 指定重新发布时使用的路由键。如果省略死信路由键,RabbitMQ 通常沿用消息原来的 routing key。

拒绝、过期与溢出的处理差异

消费者主动拒绝最容易验证:当业务确认无法处理某条消息时,发送 basic.nack 或 basic.reject 并设置 requeue=false,消息立即离开当前消费路径并尝试进入 DLX。适合明确的不可重试错误,但不要把暂时性网络故障直接当永久失败。

TTL 是时间条件。消息只有在 RabbitMQ 判定其在队列中已经过期后才会触发死信处理,因此“设置 TTL”不等于消息到达那个毫秒点就立刻被外部观察到转移。实际时机还受队列内部处理机制影响。

队列长度限制则是容量条件。默认行为会从队头移除较旧消息,这些消息可被 dead-letter;若使用 reject-publish,新发布消息被拒绝但不会因此进入 DLX,只有 reject-publish-dlx 才会把这类被拒绝消息送入死信流程。Quorum Queue 的 delivery limit 针对反复重新投递的消息,超过上限后可将其 dead-letter。

排查死信没有到达目标队列

遇到“消息应该死信但目标队列为空”时,应按链路顺序检查:先确认触发条件是否真的发生,再检查源队列是否配置了 DLX,然后确认交换机与绑定是否存在、路由键是否匹配。只看到消费者报错并不足以证明消息进入了死信流程,尤其要确认拒绝时是否错误地使用了 requeue=true。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

哪些消息会进入死信流程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通