RabbitMQ中消息什么时候会进入死信交换机

RabbitMQ中消息进入死信交换机的场景

当消息无法被正常处理时，它们会进入死信交换机（Dead Letter Exchange, DLX）。常见场景包括：

1. 消息被拒绝且不重新入队：消费者明确拒绝消息（如basic.reject或basic.nack）并设置requeue=false。
2. 消息过期（TTL超时）：消息在队列中存活时间超过设定的TTL（Time-To-Live）。TTL可通过队列的x-message-ttl参数或消息本身的expiration属性设置。
3. 队列满被丢弃：队列达到最大长度限制，新消息被丢弃并进入死信。
4. 消息无法路由：消息无法被投递到任何队列（需配合备用交换机使用）。消息所在的队列被删除，或队列未绑定到任何交换机且无法路由。

要启用死信处理，需在声明队列时配置参数：

• x-dead-letter-exchange：指定死信交换机名称
• x-dead-letter-routing-key：指定路由键（可选）

---

Java示例代码

以下示例模拟消息被拒绝进入死信的场景（使用RabbitMQ Java客户端）：

import com.rabbitmq.client.*;
import java.util.HashMap;
import java.util.Map;

public class RabbitMQDLXExample {
    private static final String NORMAL_EXCHANGE = "normal_exchange";
    private static final String NORMAL_QUEUE = "normal_queue";
    private static final String DLX_EXCHANGE = "dlx_exchange";
    private static final String DLX_QUEUE = "dlx_queue";

    public static void main(String[] args) throws Exception {
        ConnectionFactory factory = new ConnectionFactory();
        factory.setHost("localhost"); // 连接到RabbitMQ服务器

        try (Connection connection = factory.newConnection();
             Channel channel = connection.createChannel()) {

            // 1. 声明死信交换机和队列
            channel.exchangeDeclare(DLX_EXCHANGE, BuiltinExchangeType.DIRECT);
            channel.queueDeclare(DLX_QUEUE, true, false, false, null);
            channel.queueBind(DLX_QUEUE, DLX_EXCHANGE, ""); // 绑定路由键

            // 2. 声明正常队列并设置死信参数
            Map<String, Object> args = new HashMap<>();
            args.put("x-dead-letter-exchange", DLX_EXCHANGE); // 指向死信交换机
            channel.queueDeclare(NORMAL_QUEUE, true, false, false, args);
            channel.exchangeDeclare(NORMAL_EXCHANGE, BuiltinExchangeType.DIRECT);
            channel.queueBind(NORMAL_QUEUE, NORMAL_EXCHANGE, "");

            // 3. 发布测试消息
            String message = "测试死信消息!";
            channel.basicPublish(NORMAL_EXCHANGE, "", null, message.getBytes());
            System.out.println("✅ 发送消息: " + message);

            // 4. 模拟消费者拒绝消息（进入死信）
            DeliverCallback deliverCallback = (consumerTag, delivery) -> {
                String receivedMsg = new String(delivery.getBody(), "UTF-8");
                System.out.println("❌ 拒绝消息: " + receivedMsg);
                channel.basicReject(delivery.getEnvelope().getDeliveryTag(), false); // requeue=false
            };
            channel.basicConsume(NORMAL_QUEUE, false, deliverCallback, consumerTag -> {});
        }
    }
}

代码说明：

• 消息被basicReject拒绝后进入死信交换机。
• 运行后检查RabbitMQ管理界面，可见死信队列（dlx_queue）中的消息。

注意：死信交换机的行为与普通交换机相同，需确保其已正确声明并绑定到队列。