RabbitMQ之消息有效期与死信

傷城~ 2023-06-17 06:59 20阅读 0赞

### 一.前言 ###

RabbitMQ的TTL全称为Time-To-Live，表示的是消息的有效期。消息如果在队列中一直没有被消费并且存在时间超过了TTL，消息就会变成了"死信" (Dead Message)，后续无法再被消费了。如果不设置TTL，则表示此消息永久有效（默认消息是不会失效的）。如果将TTL设为0，则表示如果消息不能被立马消费则会被立即丢掉，这个特性可以部分替代RabbitMQ3.0以前支持的immediate参数，之所以所部分代替，是应为immediate参数在投递失败会有basic.return方法将消息体返回（这个功能可以利用死信队列来实现）。

设置TTL有两种方式：

*  队列有效期：是声明队列的时候，在队列的属性中设置，这样该队列中的消息都会有相同的有效期
 *  消息有效期：发送消息时给消息设置属性，可以为每条消息都设置不同的TTL

如果两种方式都设置了，则以设置的较小的为准。

*  区别：如果声明队列时设置了有效期，则消息过期了就会被删掉；如果是发消息时设置的有效期，消息过期了也不会被立马删掉，因为这时消息是否过期是在要投递给消费者时判断的。

### 二.设置消息有效期 ###

##### 1.设置队列的有效期TTL #####

定义队列的方法如下：

Queue.DeclareOk queueDeclare(String queue, boolean durable, boolean exclusive, boolean autoDelete,
                                     Map<String, Object> arguments) throws IOException;

该方法的arguments参数可以设置队列的属性，属性名为x-message-ttl，单位为毫秒。后台添加的话如下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA1MjAxNDY_size_16_color_FFFFFF_t_70]  
代码中设置如下：

Map<String, Object> arguments= new HashMap<String , Object>();
    arguments.put("x-message-ttl " , 10000);//10秒钟 单位为毫秒
    channel.queueDeclare(queueName , durable , exclusive , autoDelete , arguments) ;

命令行模式来设置：

rabbitmqctl set_policy TTL ".*" '{"message-ttl":100000}' --apply-to queues

通过HTTP接口调用：

$ curl -i -u guest:guest -H "content-type:application/json"  -XPUT -d'{"auto_delete":false,"durable":true,"arguments":{"x-message-ttl": 100000}}' 
    http://ip:15672/api/queues/{vhost}/{queuename}

##### 2.设置队列的有效期Expire #####

有效期Expire可以让队列在指定时间内 “未被使用” 的话会自动过期删除，未使用的意思是 queue 上没有任何 consumer，queue 没有被重新声明，并且在过期时间段内未调用过 basic.get 命令。该方式可用于，例如，RPC-style 的回复 queue, 其中许多queue 会被创建出来，但是却从未被使用。

服务器会确保在过期时间到达后 queue 被删除，但是不保证删除的动作有多么的及时。在服务器重启后，持久化的queue 的超时时间将重新计算。 x-expires 参数值以毫秒为单位，并且服从和 x-message-ttl 一样的约束条件，且不能设置为 0 。所以，如果该参数设置为 10000 ，则表示该 queue 如果在 10s之内未被使用则会被删除。

代码如下：

Map<String, Object> args = new HashMap<String, Object>();  
    args.put("x-expires", 10000); 
    channel.queueDeclare("queue", false, false, false, args);

##### 3.通过发送消息时设置有效期 #####

发送消息的方法如下：

void basicPublish(String exchange, String routingKey, BasicProperties props, byte[] body) throws IOException;

在该方法的props参数可以设置其有效期：

Map<String, Object> headers = new HashMap<String, Object>();
                            AMQP.BasicProperties properties = new AMQP.BasicProperties().builder()
                                    .deliveryMode(2) // 消息持久
                                    .contentEncoding("UTF-8") // 编码方式
                                    .contentType("text/plain")
                                    .expiration("100000")
                                    .headers(headers)
                                    .build();
          channel.basicPublish("", queueName, properties, message.getBytes());

通过HTTPAPI 接口设置：

$ curl -i -u guest:guest -H "content-type:application/json"  -XPOST -d
    '{"properties":{"expiration":"100000"},"routing_key":"routingkey","payload":"bodys","payload_encoding":"string"}'  
    http://localhost:15672/api/exchanges/{ vhost}/{ exchangename}/publish

### 三.死信交换机DLX ###

##### 介绍 #####

*  死信队列：DLX，dead-letter-exchange
 *  利用DLX，当消息在一个队列中变成死信 (dead message) 之后，它能被重新publish到另一个Exchange，这个Exchange就是DLX

##### 消息变成死信几种情况 #####

*  消息被拒绝(Basic.Reject/Basic.Nack) ，井且设置requeue 参数为false
 *  消息过期
 *  队列达到最大长度

##### 死信处理过程 #####

*  DLX也是一个正常的Exchange，和一般的Exchange没有区别，它能在任何的队列上被指定，实际上就是设置某个队列的属性。
 *  当这个队列中有死信时，RabbitMQ就会自动的将这个消息重新发布到设置的Exchange上去，进而被路由到另一个队列。
 *  可以监听这个队列中的消息做相应的处理。

##### 用途 #####

*  通过监控消费死信队列中消息，来观察和分析数据。
 *  结合TTL实现延迟队列（比如下单超过多长时间自动关闭）

##### 使用 #####

代码如下：

channel.exchangeDeclare("dlx_exchange" , "direct"); //创建DLX: dlx_exchange
    Map<String, Object> args = new HashMap<String, Object>();
    args.put("x-dead-letter-exchange" , "dlx_exchange ");//设置死信交换机
    args.put("x-dead-letter-routing-key" , "dlx-routing-key");//设置DLX的路由键(可以不设置)
    channel.queueDeclare("myqueue" , false , false , false , args);

##### 实例 #####

public static void main(String[] args) throws Exception { 
    		Connection connection = ConnectionUtil.getConnection();
    		Channel channel = connection.createChannel();
    		//声明一个交换机，做死信交换机用
    		channel.exchangeDeclare("dlx_exchange", "topic", true, false, null);
    		//声明一个队列，做死信队列用
    		channel.queueDeclare("dlx_queue", true, false, false, null);
    		//队列绑定到交换机上
    		channel.queueBind("dlx_queue", "dlx_exchange", "dlx.*");
    		
    		channel.exchangeDeclare("normal_exchange", "fanout", true, false, null);
    		Map<String, Object> arguments=new HashMap<String, Object>();
    		arguments.put("x-message-ttl" , 1000);//设置消息有效期1秒，过期后变成私信消息，然后进入DLX
    		arguments.put("x-dead-letter-exchange" , "dlx_exchange");//设置DLX
    		arguments.put("x-dead-letter-routing-key" , "dlx.test");//设置DLX的路由键
    		//为队列normal_queue 添加DLX
    		channel.queueDeclare("normal_queue", true, false, false, arguments);
    		channel.queueBind("normal_queue", "normal_exchange", "");
    		
    		channel.basicPublish("normal_exchange", "", MessageProperties.PERSISTENT_TEXT_PLAIN, ("测试死信消息").getBytes());
    		System.out.println("发送消息时间:"+ConnectionUtil.formatDate(new Date()));
    		
    		channel.close();
    		connection.close();
    	}

###### 说明： ######

申明死信队列dlx\_queue的绑定如下，与死信交换机dlx\_exchange（topic类型）进行绑定，routing key为"dlx.\*"  
申明队列normal\_queue，与交换机normal\_exchange（fanout类型）进行绑定

执行流程：

*  消息发送到交换机normal\_exchange，然后路由到队列normal\_queue上
 *  因为队列normal\_queue没有消费者，消息过期后成为死信消息
 *  死信消息携带设置的x-dead-letter-routing-key=dlx.test进入到死信交换机dlx\_exechage
 *  dlx\_exechage与dlx\_queue绑定的routing key为"dlx.\*"，死信消息的路由键dlx.test符合该规则被路由到dlx.queue上面。

###### 参考： ######

https://www.jianshu.com/p/986ee5eb78bc  
https://blog.csdn.net/u012988901/article/details/88958654

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA1MjAxNDY_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20191128085055525.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTA1MjAxNDY=,size_16,color_FFFFFF,t_70