RabbitMQ死信队列学习笔记

视频地址

死信的概念

先从概念解释上搞清楚这个定义，死信，顾名思义就是无法被消费的消息，字面意思可以这样理解，一般来说，producer 将消息投递到 broker 或者直接到 queue 里了，consumer 从 queue 取出消息进行消费，但某些时候由于特定的原因导致 queue 中的某些消息无法被消费，这样的消息如果没有后续的处理，就变成了死信，有死信自然就有了死信队列。

应用场景:为了保证订单业务的消息数据不丢失，需要使用到 RabbitMQ 的死信队列机制，当消息消费发生异常时，将消息投入死信队列中.还有比如说: 用户在商城下单成功并点击去支付后在指定时间未支付时自动失效。

死信的来源

• 消息达到了最大存活时间
• 消息被拒绝消费
• 队列达到最大长度

实验代码

• 以消息超过存活时间为例

package com.dongmu.deadMesg;

import com.dongmu.util.RabbitMQUtil;
import com.rabbitmq.client.BuiltinExchangeType;
import com.rabbitmq.client.CancelCallback;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.DeliverCallback;

import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

public class Consumer1 {
    //普通交换机名称
    private static final String NORMAL_EXCHANGE = "normal_exchange";
    //死信交换机名称
    private static final String DEAD_EXCHANGE = "dead_exchange";

    //普通队列名称
    private static final String NORMAL_QUEUE = "normal_queue";
    //死信队列名称
    private static final String DEAD_QUEUE = "dead_queue";

    public static void main(String[] args) throws Exception {
        Channel channel = RabbitMQUtil.getChannel();


        //声明普通交换机和死信交换机
        channel.exchangeDeclare(NORMAL_EXCHANGE, BuiltinExchangeType.DIRECT);
        channel.exchangeDeclare(DEAD_EXCHANGE, BuiltinExchangeType.DIRECT);

        //声明普通队列

        Map map = new HashMap<>();
        //设置过期时间,这里也可以不设置，这里设置了之后就是死的了，这里不设置也可以通过发消息的那一方在
        //发消息的时候指定消息的过期时间
//        map.put("x-message-ttl",10000);
        //为正常队列设置死信交换机
        map.put("x-dead-letter-exchange",DEAD_EXCHANGE);
        //设置死信routingkey
        map.put("x-dead-letter-routing-key","lisi");

        channel.queueDeclare(NORMAL_QUEUE,false,false,false,map);

        //死信队列
        channel.queueDeclare(DEAD_QUEUE,false,false,false,null);

        //绑定普通交换机和普通队列
        channel.queueBind(NORMAL_QUEUE,NORMAL_EXCHANGE,"zhangsan");
        //绑定死信交换机和死信队列
        channel.queueBind(DEAD_QUEUE,DEAD_EXCHANGE,"lisi");

        DeliverCallback deliverCallback = (consumerTag,message)->{
            System.out.println("接收到了消息"+new String(message.getBody(), StandardCharsets.UTF_8));
        };

        CancelCallback cancelCallback = (mesg)->{
            System.out.println("接收消息"+mesg+"失败。");
        };
        channel.basicConsume(NORMAL_QUEUE,true,deliverCallback,cancelCallback);
    }
}

package com.dongmu.deadMesg;

import com.dongmu.util.RabbitMQUtil;
import com.rabbitmq.client.AMQP;
import com.rabbitmq.client.BuiltinExchangeType;
import com.rabbitmq.client.Channel;

import java.util.HashMap;
import java.util.Map;
import java.util.Scanner;

public class Producer {
    //普通交换机名称
    private static final String NORMAL_EXCHANGE = "normal_exchange";

    public static void main(String[] args) throws Exception {
        Channel channel = RabbitMQUtil.getChannel();

        channel.exchangeDeclare(NORMAL_EXCHANGE, BuiltinExchangeType.DIRECT);
        String message = "dongmu";
        Scanner scanner = new Scanner(System.in);

        //设置过期时间
        AMQP.BasicProperties basicProperties = new  AMQP.BasicProperties().builder().expiration("10000").build();

        
        while (scanner.hasNext()){
            message = scanner.next();
            channel.basicPublish(NORMAL_EXCHANGE,"zhangsan",basicProperties,message.getBytes());
            System.out.println("发送消息"+message+"成功。");
        }
    }
}

首先我们把消费者启动，然后启动生产者发送消息，测试一下生产者生产的消息是否可以正常被消费者消费，测试正常之后我们把消费者关闭然后，用生产者发送消息，可以发现消息在设置的过期之间10s之后由普通队列进入了死信队列。

补全我们处理死信消息的消费者diamagnetic

package com.dongmu.deadMesg;

import com.dongmu.util.RabbitMQUtil;
import com.rabbitmq.client.BuiltinExchangeType;
import com.rabbitmq.client.CancelCallback;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.DeliverCallback;

import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

public class Consumer2 {
    //死信队列名称
    private static final String DEAD_QUEUE = "dead_queue";

    public static void main(String[] args) throws Exception {
        Channel channel = RabbitMQUtil.getChannel();

        //死信队列
        channel.queueDeclare(DEAD_QUEUE,false,false,false,null);

        DeliverCallback deliverCallback = (consumerTag,message)->{
            System.out.println("接收到了死信消息"+new String(message.getBody(), StandardCharsets.UTF_8));
        };

        CancelCallback cancelCallback = (mesg)->{
            System.out.println("接收消息"+mesg+"失败。");
        };
        channel.basicConsume(DEAD_QUEUE,true,deliverCallback,cancelCallback);
    }
}

启动之后就可以消费掉刚才的死信消息

• 假如想要设置队列最大长度，则修改代码

这里要注意一下，由于队列的属性被我们改了，所以要把原来的队列删除了之后再重新启动，不然会报错的。

在consumer1中添加下面的代码

//这里可以设置队列最大长度，超过这个长度的消息将被放入死信队列
        map.put("x-max-length",6);

然后去掉我们生产者当中的消息的时间限制方便我们演示。
先把三个全部打开，然后发送1测试，然后关闭消费者1，继续进行发送
效果如下



可以发现，如果队列元素超过了最大长度的限制，队列头部的元素将会进入死信队列，要注意这里是队列头部的元素，而不是队列尾部新添加的元素。

• 队列中的消息被拒收则会进入死信队列演示

首先关闭长度限制方便我们演示，然后把自动应答改成手动应答
代码修改成如下样子

package com.dongmu.deadMesg;

import com.dongmu.util.RabbitMQUtil;
import com.rabbitmq.client.BuiltinExchangeType;
import com.rabbitmq.client.CancelCallback;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.DeliverCallback;

import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

public class Consumer1 {
    //普通交换机名称
    private static final String NORMAL_EXCHANGE = "normal_exchange";
    //死信交换机名称
    private static final String DEAD_EXCHANGE = "dead_exchange";

    //普通队列名称
    private static final String NORMAL_QUEUE = "normal_queue";
    //死信队列名称
    private static final String DEAD_QUEUE = "dead_queue";

    public static void main(String[] args) throws Exception {
        Channel channel = RabbitMQUtil.getChannel();


        //声明普通交换机和死信交换机
        channel.exchangeDeclare(NORMAL_EXCHANGE, BuiltinExchangeType.DIRECT);
        channel.exchangeDeclare(DEAD_EXCHANGE, BuiltinExchangeType.DIRECT);

        //声明普通队列

        Map map = new HashMap<>();
        //设置过期时间,这里也可以不设置，这里设置了之后就是死的了，这里不设置也可以通过发消息的那一方在
        //发消息的时候指定消息的过期时间
//        map.put("x-message-ttl",10000);
        //为正常队列设置死信交换机
        map.put("x-dead-letter-exchange",DEAD_EXCHANGE);
        //设置死信routingkey
        map.put("x-dead-letter-routing-key","lisi");
        //这里可以设置队列最大长度，超过这个长度的消息将被放入死信队列
//        map.put("x-max-length",6);

        channel.queueDeclare(NORMAL_QUEUE,false,false,false,map);

        //死信队列
        channel.queueDeclare(DEAD_QUEUE,false,false,false,null);

        //绑定普通交换机和普通队列
        channel.queueBind(NORMAL_QUEUE,NORMAL_EXCHANGE,"zhangsan");
        //绑定死信交换机和死信队列
        channel.queueBind(DEAD_QUEUE,DEAD_EXCHANGE,"lisi");

        DeliverCallback deliverCallback = (consumerTag,message)->{
            String s = new String(message.getBody(), StandardCharsets.UTF_8);

            //如果收到了消息是3则拒接接收，false表示不重新放入普通队列，就会进入死信队列
            if ("3".equals(s)){
                channel.basicReject(message.getEnvelope().getDeliveryTag(),false);
            }else {
                //false表示不进行批量应答
                channel.basicAck(message.getEnvelope().getDeliveryTag(),false);
                System.out.println("接收到了消息"+s);
            }
        };

        CancelCallback cancelCallback = (mesg)->{
            System.out.println("接收消息"+mesg+"失败。");
        };
        //开启手动应答
        channel.basicConsume(NORMAL_QUEUE,false,deliverCallback,cancelCallback);
    }
}

演示结果