消息队列 / 系统课时

配置死信交换机

配置死信交换机

业务队列中的消息被拒绝、过期或超过队列限制后,不应直接消失。本课用一个可运行示例配置死信交换机、死信路由键和死信队列,并验证被拒绝的消息能够自动进入异常消息出口。

学习目标

  • 理解死信交换机、业务队列与死信队列之间的关系
  • 为业务队列配置死信交换机和死信路由键
  • 通过拒绝消息验证死信链路是否生效

死信交换机解决什么问题

死信交换机并不是特殊类型的 Exchange,而是业务队列在消息成为“死信”后重新发布消息的目标交换机。常见触发条件包括消费者使用 basic.reject 或 basic.nack 且不重新入队、消息 TTL 到期,以及队列达到长度限制后淘汰消息。

一条典型链路包含业务交换机 orders.x、业务队列 orders.work、死信交换机 orders.dlx 和死信队列 orders.dead。业务消费者只处理正常消息;异常消息通过独立路由进入死信队列,便于补偿、审计或人工处理。

业务消息转为死信后的路由链路

配置并验证死信链路

下面的 Python 程序会声明完整拓扑,发送一条消息,从业务队列取出后使用 basic_nack(requeue=False) 拒绝,再轮询死信队列确认消息已经被重新路由。前提是本机 RabbitMQ 已运行,且 Python 环境已安装 pika。

python
import json
import time
import pika

connection = pika.BlockingConnection(
    pika.ConnectionParameters(host="localhost")
)
channel = connection.channel()

channel.exchange_declare("orders.x", exchange_type="direct", durable=True)
channel.exchange_declare("orders.dlx", exchange_type="direct", durable=True)

channel.queue_declare(
    "orders.work",
    durable=True,
    arguments={
        "x-dead-letter-exchange": "orders.dlx",
        "x-dead-letter-routing-key": "orders.failed",
    },
)
channel.queue_declare("orders.dead", durable=True)

channel.queue_bind("orders.work", "orders.x", routing_key="orders.created")
channel.queue_bind("orders.dead", "orders.dlx", routing_key="orders.failed")

channel.basic_publish(
    exchange="orders.x",
    routing_key="orders.created",
    body=json.dumps({"orderId": 1001}),
    properties=pika.BasicProperties(delivery_mode=2),
)

method, _, body = channel.basic_get("orders.work", auto_ack=False)
if method is None:
    raise RuntimeError("orders.work 中没有可拒绝的消息")

channel.basic_nack(method.delivery_tag, requeue=False)

deadline = time.time() + 5
dead_body = None
while time.time() < deadline:
    dead_method, _, dead_body = channel.basic_get("orders.dead", auto_ack=True)
    if dead_method is not None:
        break
    time.sleep(0.1)

if dead_body is None:
    raise RuntimeError("5 秒内未观察到死信")

print(dead_body.decode())
connection.close()

预期输出

text
{"orderId": 1001}

实际环境中如果队列已有旧消息,测试前应使用独立测试队列或先清理测试数据,避免把历史消息误判为本次结果。

生产环境优先使用策略

示例中的 x-dead-letter-exchange 和 x-dead-letter-routing-key 属于队列声明参数,适合最小实验,但一旦队列已经存在,修改这些参数通常需要重新声明队列。生产环境更适合通过 RabbitMQ Policy 管理死信配置,使运维侧可以在不修改应用代码的情况下调整规则。

例如,对名称精确匹配 orders.work 的队列设置死信策略:

bash
rabbitmqctl set_policy DLX "^orders\.work$" '{"dead-letter-exchange":"orders.dlx","dead-letter-routing-key":"orders.failed"}' --apply-to queues

预期输出

text
Setting policy "DLX" for pattern "^orders\.work$" to "{"dead-letter-exchange":"orders.dlx","dead-letter-routing-key":"orders.failed"}" with priority "0" for vhost "/" ...

命令的提示文本可能因 RabbitMQ CLI 版本略有差异,判断是否成功应以策略实际存在并且死信能够进入目标队列为准。

配置时容易忽略的边界

死信交换机必须在消息发生死信转发时可用,并且它仍然遵循普通 Exchange 的路由规则;如果没有任何绑定匹配死信路由键,消息仍可能无法进入预期的死信队列。因此,配置 DLX 后要同时检查 Exchange、Binding 和目标 Queue,而不是只看业务队列上的两个参数。

消费者若使用 requeue=True,消息会重新回到原业务队列,不会进入 DLX。死信队列也不应只是“垃圾桶”:至少要有监控、告警和处理策略,否则异常消息只是从主链路转移到了另一个无人关注的位置。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置死信交换机

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

登录哪都通