消息队列 / 系统课时
Dead Letter Exchange 怎样配置
Dead Letter Exchange 怎样配置
当业务消息被拒绝、过期或因队列限制无法继续保留时,不能只让它“消失”。本课把业务队列接到死信交换机,再通过固定 Routing Key 路由到异常队列,并说明怎样验证这条失败链路是否真正建立。
学习目标
- 理解业务队列、死信交换机和异常队列之间的关系
- 能用策略配置
dead-letter-exchange与dead-letter-routing-key - 能判断消息为什么没有进入预期的死信队列
先把死信拓扑搭清楚
DLX 本质上仍是普通 Exchange。区别不在交换机本身,而在业务队列配置了“消息成为死信后要重新发布到哪个 Exchange”。因此完整链路至少包含业务队列 business.q、死信交换机 business.dlx、死信队列 business.failed,以及从 DLX 到死信队列的 Binding。

如果只配置 dead-letter-exchange 而没有指定新的 Routing Key,RabbitMQ 会继续使用消息原先的路由键。显式配置 dead-letter-routing-key 能让失败消息统一进入专门的异常路由,排查时更直观。
用策略配置 DLX
生产环境更适合用 Policy 配置 DLX,因为策略可以动态调整;把 x-dead-letter-exchange 等参数硬编码在队列声明里,后续修改通常需要重新声明队列。下面假设 RabbitMQ 已启用管理插件,并安装了 rabbitmqadmin v2;默认虚拟主机 / 中创建一套最小拓扑,再对 business.q 应用死信策略。
rabbitmqadmin exchanges declare --name "business.dlx" --type "direct" --durable true
rabbitmqadmin queues declare --name "business.failed" --type "classic" --durable true --auto-delete false
rabbitmqadmin bindings declare --source "business.dlx" --destination-type "queue" --destination "business.failed" --routing-key "failed"
rabbitmqadmin queues declare --name "business.q" --type "classic" --durable true --auto-delete false
rabbitmqctl set_policy business-dlx '^business\.q$' '{"dead-letter-exchange":"business.dlx","dead-letter-routing-key":"failed"}' --apply-to queues预期结果
business.dlx、business.failed、business.q 均成功声明,business.q 命中 business-dlx 策略;其死信将以 routing key=failed 重新发布到 business.dlx。这里的策略定义使用 dead-letter-exchange 和 dead-letter-routing-key,而不是队列参数形式的 x-dead-letter-*。二者表达的是同一类行为,但策略更便于运维调整。
哪些消息会进入 DLX
常见触发条件包括:消费者 basic.reject 或 basic.nack 且 requeue=false;消息达到 TTL;队列因长度限制移除消息;以及 quorum queue 消息超过配置的投递次数限制。消费者处理失败但选择重新入队,并不会立刻形成死信。
路由不到异常队列时怎么查
先检查源队列是否真的命中 Policy,再确认 business.dlx 已存在,最后核对 DLX 到 business.failed 的 Binding 是否使用 failed。DLX 和源队列必须位于同一 virtual host,声明源队列的用户还需要具备相应的读写权限。
如果 DLX 名称写错、交换机在死信发生时不存在,或 Routing Key 与 Binding 不匹配,消息都可能无法进入目标异常队列。配置完成后,验证重点不是“策略存在”本身,而是制造一次真实失败条件并观察异常队列是否收到消息。