消息队列 / 系统课时

死信产生条件

死信产生条件

死信不是一种预先声明的消息类型,而是消息离开原队列时触发的一次重新发布。要正确设计重试和异常收集,必须先分清哪些事件会触发死信、哪些只是重新入队,以及源队列没有可用 DLX 时消息会发生什么。

学习目标

  • 识别 RabbitMQ 4.3 中会触发死信的主要条件
  • 区分 requeue=false、消息 TTL、队列长度限制与 Quorum Queue 投递上限
  • 使用 Policy 配置 DLX,并根据死信原因验证路由

死信发生在源队列离开消息时

消息先进入普通队列,满足死信条件后,RabbitMQ 才会把它重新发布到该队列配置的 Dead Letter Exchange。DLX 本质上仍是普通 Exchange,之后继续按交换机类型、Routing Key 和 Binding 路由到一个或多个死信队列。

RabbitMQ 死信产生条件与路由

四类事件会产生死信

第一类是消费者明确拒绝消息。AMQP 0-9-1 使用 basic.reject 或 basic.nack 且 requeue=false 时,消息不会重新进入原队列,而会进入死信处理;如果 requeue=true,它仍属于重新投递路径,不是这次拒绝直接产生的死信。

第二类是消息 TTL 到期。无论 TTL 来自队列级消息 TTL 还是发布消息携带的过期时间,消息一旦按 RabbitMQ 的过期规则被移除,就可以进入 DLX。要特别区分“消息 TTL”和“Queue TTL”:整个队列因过期被删除时,队列里的消息不会因此逐条死信。

第三类是队列超过长度或字节限制后有消息被淘汰。例如默认 drop-head 会处理最旧的 Ready 消息;若源队列配置了 DLX,被长度限制淘汰的消息可以按 maxlen 原因进入死信路径。

第四类只与 Quorum Queue 的投递上限有关:消息的失败投递次数超过 delivery-limit 后会被移除;配置了 DLX 时,它会以 delivery_limit 原因死信。RabbitMQ 4.3 的该计数基于 delivery-count,普通 basic.nack 重新入队并不会因为反复调用就自动累计到这个上限。

为源队列配置 DLX

假设 orders.dlx 已经存在,并且已经通过 Binding 连接到实际的死信队列,可以用 Policy 把 orders.work 的死信统一转发到该交换机,并指定新的 Routing Key。

bash
# 将源队列的死信转发到指定 DLX,并改用固定 Routing Key
rabbitmqctl set_policy orders-dlx '^orders\.work$' \
  '{"dead-letter-exchange":"orders.dlx","dead-letter-routing-key":"orders.dead"}' \
  --apply-to queues \
  --priority 10

# 核对 Policy 是否已经生效
rabbitmqctl list_policies --formatter=pretty_table --silent

预期结果

text
策略 orders-dlx 匹配 orders.work,definition 中包含 dead-letter-exchange=orders.dlx 和 dead-letter-routing-key=orders.dead。
之后 orders.work 中满足死信条件的消息会尝试重新发布到 orders.dlx,并使用 orders.dead 参与后续路由。

从死信原因判断发生了什么

死信消息会携带与死亡历史相关的元数据。排查时优先关注首次或最近一次死亡原因,而不是只看“消息出现在死信队列”这个结果。

原因 对应事件
rejected 消费者拒绝且不重新入队
expired 消息 TTL 到期
maxlen 队列长度或字节限制导致消息被移除
delivery_limit Quorum Queue 超过投递失败次数上限

死信队列只解决“把异常消息移到哪里”,并不自动等于重试机制。真正的重试还需要定义延迟、最大次数、再次投递的目标以及最终失败后的处置,否则简单地把死信重新送回原队列,很容易形成高频循环。

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

目录与阅读设置

阅读设置

17

记录一个想法

死信产生条件

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

登录哪都通