RabbitMQ消息有效期与死信的处理过程
时间：2022-10-09 15:33:27 | 栏目：JAVA代码 | 点击：次
一.前言
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，单位为毫秒。后台添加的话如下：
代码中设置如下：
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上面。
参考：