RabbitMQ 死信队列：超时消息与错误路由的关键枢纽

原创 2026-07-23 11:44:52 · 爱名网(22科技集团) · 小蒋

关注

RabbitMQ死信队列用于处理无法正常消费的消息，如超时、拒绝或队列满等情况。消息变为死信后，经死信交换机路由至死信队列，实现异常、延迟或过期消息的统一管控与重试。

免费领取国家顶级域名（.cn/.中国）

欢迎加入国家域名信源站点导航

站点智能：AI搭建 AI辅助运营独立站，把生意做到全世界

在实际的消息队列应用中，我们经常会遇到这样的情况：一条消息因为某些原因无法被消费者成功处理。可能的原因包括：

消息超时：订单支付请求发出后，用户20秒内未完成支付，这条消息需要被取消。
消费失败：消费者因网络或业务逻辑问题无法处理消息，需要重试或转移。
消息过期：某些通知类消息有严格的时效性，超时即失去处理价值。

为了解决这些问题，RabbitMQ 提供了一个重要的高级特性——死信队列（Dead Letter Queue，简称 DLQ）。它就像一个“消息的临时收容所”，当消息在队列中成为“死信”（未被正常消费）时，会被自动转移到死信交换机，然后路由到死信队列进行特殊处理。

什么是“死信”？

在 RabbitMQ 中，消息变成死信主要有三种情况：

消息被消费者拒绝，且 requeue 参数设置为 false（不重新入队）。
消息在队列中存活时间超时（设置了 TTL，即 Time To Live）。
队列达到最大长度，导致消息被溢出。

当消息变成死信后，它不会凭空消失，而是会被发送到该队列关联的“死信交换机”（Dead Letter Exchange），最终进入“死信队列”。这正是处理异常、延迟或超时消息的核心机制。

核心实现：配置与验证

要运用死信队列，需要完成两步关键配置，并用代码验证。

前置准备

默认根目录已经安装composer下载安装rabbitmq（php-amqplib/php-amqplib）扩展。

生产者：创建带死信配置的队列

在生产者代码中，我们除了声明业务队列，还需要在队列声明时添加一个特殊的参数表（$args），来配置死信策略。关键参数包括：

x-message-ttl：设置消息的过期时间（毫秒）。
x-dead-letter-exchange：指定死信要发送到的死信交换机。
x-dead-letter-routing-key：指定死信发送到死信交换机时使用的路由键。

<?php
require_once __DIR__ . '/vendor/autoload.php';
use PhpAmqpLib\Connection\AMQPStreamConnection;
use PhpAmqpLib\Message\AMQPMessage;
use PhpAmqpLib\Wire\AMQPTable;

$dbName = 'sanqing';
$dbPwd = '111111';
$tableName = 'order';

$connection = new AMQPStreamConnection('localhost', 5672, $dbName, $dbPwd, $tableName);
$channel = $connection->channel();

$exc_name = 'exc_pay';
$routing_key = 'route_pay';
$queue_name = 'queue_pay';
$ttl = 20000;
$dead_exc_name = 'dead_exc_pay';
$dead_routing_key = 'dead_route_pay';
$dead_queue_name = 'dead_queue_pay';

$channel->exchange_declare($exc_name,'direct',false,false,false);
$args = new AMQPTable([
    'x-message-ttl'=>$ttl,
    'x-dead-letter-exchange'=>$dead_exc_name,
    'x-dead-letter-routing-key'=>$dead_routing_key
]);
$channel->queue_declare($queue_name,false,true,false,false,false,$args);
$channel->queue_bind($queue_name,$exc_name,$routing_key);

// 申明死信队列
$channel->exchange_declare($dead_exc_name,'direct',false,false,false);
$channel->queue_declare($dead_queue_name,false,true,false,false,false);
$channel->queue_bind($dead_queue_name,$dead_exc_name,$dead_routing_key);

$data = 'this is '.$routing_key.' dead message';
$msg = new AMQPMessage($data,['delivery_mode'=>AMQPMessage::DELIVERY_MODE_PERSISTENT]);
$channel->basic_publish($msg,$exc_name,$routing_key);

$channel->close();
$connection->close();

消费者：监听死信队列

消费者 dead_work.php 的逻辑则非常直接，它只关心并监听死信队列 dead_queue_pay。当业务队列中的消息因为超时（20秒后）变成死信后，就会被路由到这里，由消费者处理。这实现了正常的“业务队列”与“死信队列”的物理隔离。

<?php
require_once __DIR__ . '/vendor/autoload.php';
use PhpAmqpLib\Connection\AMQPStreamConnection;

$dbName = 'sanqing';
$dbPwd = '111111';
$tableName = 'order';

$connection = new AMQPStreamConnection('localhost', 5672, $dbName, $dbPwd, $tableName);
$channel = $connection->channel();

$dead_exc_name = 'dead_exc_pay';
$dead_routing_key = 'dead_route_pay';
$dead_queue_name = 'dead_queue_pay';

$channel->exchange_declare($dead_exc_name,'direct',false,false,false);
$channel->queue_bind($dead_queue_name,$dead_exc_name,$dead_routing_key);

$callback = function($msg){
    echo 'received '.$msg->body."\n";
    $msg->ack();
};
$channel->basic_qos(null,1,null);
$channel->basic_consume($dead_queue_name,'',false,false,false,false,$callback);

while($channel->is_open()){
    $channel->wait();
}

$channel->close();
$connection->close();

运行验证

先启动消费者，它会持续监听死信队列：

php dead_work.php

然后启动生产者发送一条消息：

php dead_pub.php

你会看到，消费者并不会立刻收到消息，而是在 20 秒后才打印出 received this is route_pay dead message，完美验证了死信队列的超时转移功能。

总结

死信队列是构建高可靠性、高韧性的消息驱动系统的关键组件。它的核心价值在于：

关键点	说明
故障隔离	将无法正常处理的消息隔离到死信队列，避免阻塞主队列。
延迟处理	通过 TTL 和死信队列组合，可以实现消息延迟消费的效果。
异常监控	通过监控死信队列的消息，可以及时发现系统异常或消息处理瓶颈。
灵活的重试与补偿	可以编写消费者从死信队列读取消息，进行重试、记录日志、人工介入或补偿操作。

通过本教程，你已经掌握了如何为消息设置 TTL 和死信策略，并实现了消息在超时后的自动转移与消费。这是在生产环境中使用 RabbitMQ 时非常实用且重要的一环。

RabbitMQ

死信队列

消息超时

消费失败

消息过期

阅读全文