--- highlight: a11y-dark theme: smartblue --- # 前言死信：无法被消费的消息，称为死信。如果死信一直留在队列中，会导致一直被消费，却从不消费成功。所以我们专门开辟了一个来存放死信的队列，叫死信队列（DLX，`dead-letter-exchange`）。 # 死信的几种来源： - 消息 TTL 过期（time to live，存活时间，可以用在限时支付消息） - 队列达到最大长度（队列满了，无法路由到该队列） - 消息被拒绝（ `basic.reject / basic.nack` ），并且 `requeue = false` ![1655097591(1).jpg](https://p1-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/0c8f57d1a2474e2bb9e6d80d1bf7b5d0~tplv-k3u1fbpfcp-watermark.image?) ## 环境准备配置准备 MQ 的队列和环境： - 正常交换机 - - 正常队列（最长队列 5） ---- 正常消费者，拒绝消息 - ttl 队列（过期时间 60 秒） ---- 没有消费者 - 死信交换机 - - 死信队列 ### Properties 配置 ```properties spring.application.name=spring-boot-rabbitmq spring.rabbitmq.host=127.0.0.1 spring.rabbitmq.port=5672 spring.rabbitmq.username=admin spring.rabbitmq.password=admin #手动模式 spring.rabbitmq.listener.simple.acknowledge-mode=manual ``` ### Config配置 ```java import org.springframework.amqp.core.Binding; import org.springframework.amqp.core.BindingBuilder; import org.springframework.amqp.core.DirectExchange; import org.springframework.amqp.core.Queue; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import java.util.HashMap; import java.util.Map; /** * @author wxd * @version V1.0 * @description DeadConfig * @date 2022/6/13 13:55 **/ @Configuration public class DeadConfig { /* 正常配置 **********************************************************************************************************/ /** * 正常交换机，开启持久化 */ @Bean DirectExchange normalExchange() { return new DirectExchange("normalExchange", true, false); } @Bean public Queue normalQueue() { // durable: 是否持久化,默认是false,持久化队列：会被存储在磁盘上，当消息代理重启时仍然存在，暂存队列：当前连接有效 // exclusive: 默认也是false，只能被当前创建的连接使用，而且当连接关闭后队列即被删除。此参考优先级高于durable // autoDelete: 是否自动删除，当没有生产者或者消费者使用此队列，该队列会自动删除。 Map args = deadQueueArgs(); // 队列设置最大长度 args.put("x-max-length", 5); return new Queue("normalQueue", true, false, false, args); } @Bean public Queue ttlQueue() { Map args = deadQueueArgs(); // 队列设置消息过期时间 60 秒 args.put("x-message-ttl", 60 * 1000); return new Queue("ttlQueue", true, false, false, args); } @Bean Binding normalRouteBinding() { return BindingBuilder.bind(normalQueue()).to(normalExchange()).with("normalRouting"); } @Bean Binding ttlRouteBinding() { return BindingBuilder.bind(ttlQueue()).to(normalExchange()).with("ttlRouting"); } /* 死信配置 **********************************************************************************************************/ /** * 死信交换机 */ @Bean DirectExchange deadExchange() { return new DirectExchange("deadExchange", true, false); } /** * 死信队列 */ @Bean public Queue deadQueue() { return new Queue("deadQueue", true, false, false); } @Bean Binding deadRouteBinding() { return BindingBuilder.bind(deadQueue()).to(deadExchange()).with("deadRouting"); } /** * 转发到死信队列，配置参数 */ private Map deadQueueArgs() { Map map = new HashMap<>(); // 绑定该队列到私信交换机 map.put("x-dead-letter-exchange", "deadExchange"); map.put("x-dead-letter-routing-key", "deadRouting"); return map; } ``` **参数：** | 参数名 | 作用 | | --- | --- | | x-message-tti(Time-To-Live) | 发送到队列的消息在丟弃之前可以存活多长时间(毫秒) | | x-max-length | 限制队列最大长度（新增后挤出最早的），单位个数 | | x-expires | 队列没有访问超时时，自动删除（包含没有消费的消息），单位毫秒 | | x-max-length-bytes | 限制队列最大容量 | | x-dead-letter-exchange | 死信交换机，将删除/过期的数据，放入指定交换机 | | x-dead-letter-routing-key | 死信路由，将删除/过期的数据，放入指定routingKey | | x-max-priority | 队列优先级 | | x-queue-mode | 对列模式，默认lazy（将数据放入磁盘，消费时放入内存） | | x-queue-master-locator | 镜像队列 | ## 正常队列消费 ```java package com.wxd.controller; import com.alibaba.fastjson.JSONObject; import org.springframework.amqp.core.AmqpTemplate; import org.springframework.amqp.core.MessagePostProcessor; import org.springframework.amqp.rabbit.connection.CorrelationData; import org.springframework.amqp.rabbit.core.RabbitTemplate; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; import java.util.HashMap; import java.util.Map; import java.util.UUID; /** * @author wxd * @version V1.0 * @description HelloController * @date 2022/6/13 13:59 **/ @RestController public class HelloController { @Autowired private RabbitTemplate rabbitTemplate; /** * 正常消息队列，队列最大长度5 */ @GetMapping("/normalQueue") public String normalQueue() { Map map = new HashMap<>(2); map.put("messageId", String.valueOf(UUID.randomUUID())); map.put("data", System.currentTimeMillis() + ", 正常队列消息，最大长度 5"); rabbitTemplate.convertAndSend("normalExchange", "normalRouting", map, new CorrelationData()); return JSONObject.toJSONString(map); } } ``` MQ控制台： ![1655101228(1).jpg](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/27fdbfe35833452684b8c38888b9cb8d~tplv-k3u1fbpfcp-watermark.image?) ## 消息 TTL 过期队列自动消费消息的TTL 指的是消息的存活时间，我们可以通过设置消息的TTL或者队列的TTL来实现。消息的TTL ：对于设置了过期时间属性(expiration)的消息，消息如果在过期时间内没被消费，会过期队列的TTL ：对于设置了过期时间属性(x-message-ttl)的队列，所有路由到这个队列的消息，都会设置上这个过期时间。代码实现： ```java /** * 消息 TTL, time to live */ @GetMapping("/ttlToDead") public String ttlToDead() { Map map = new HashMap<>(); map.put("messageId", String.valueOf(UUID.randomUUID())); map.put("data", System.currentTimeMillis() + ", ttl队列消息"); rabbitTemplate.convertAndSend("normalExchange", "ttlRouting", map, new CorrelationData()); return JSONObject.toJSONString(map); } ``` 发送后： ![1655101423(1).jpg](https://p1-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/6ff332e80b63435aa72deb45883cd3e4~tplv-k3u1fbpfcp-watermark.image?) 过期后： ![1655101560(1).jpg](https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/077e7778c4a44deab84a390a26d2e93f~tplv-k3u1fbpfcp-watermark.image?) Demo 中只是为了方便，代码中尽量使用消息TTL，不要用队列TTL。 ## 死信队列消费 ```java import com.rabbitmq.client.Channel; import org.springframework.amqp.core.Message; import org.springframework.amqp.rabbit.annotation.RabbitHandler; import org.springframework.amqp.rabbit.annotation.RabbitListener; import org.springframework.stereotype.Component; import java.io.IOException; import java.util.Map; /** * @author wxd * @version V1.0 * @description DeadConsumer * @date 2022/6/13 14:56 **/ @Component @RabbitListener(queues = "deadQueue") public class DeadConsumer { @RabbitHandler public void process(Map message, Channel channel, Message mqMsg) throws IOException { System.out.println("死信队列收到消息 : " + message.toString()); channel.basicAck(mqMsg.getMessageProperties().getDeliveryTag(), false); } } ``` 测试结果： ``` 死信队列收到消息 : {data=1655109039693, deadQueue队列消息, messageId=9712be7c-ee04-4f8f-af00-b73b5cdcd086} 死信队列收到消息 : {data=1655109040100, deadQueue队列消息, messageId=76dc4ebb-5f61-4c2e-8dff-c6607f22b112} 死信队列收到消息 : {data=1655109040358, deadQueue队列消息, messageId=ca45aa49-6e3d-4547-a622-c53110e208a4} 死信队列收到消息 : {data=1655109040611, deadQueue队列消息, messageId=fc3d2065-4acd-48bb-bf85-6e85b2e3ae72} 死信队列收到消息 : {data=1655109040877, deadQueue队列消息, messageId=a1874299-8773-4069-8b07-c9a644df0787} 死信队列收到消息 : {data=1655109041133, deadQueue队列消息, messageId=dd6bc562-8454-424d-8a6a-84c2379c0970} ```