前言

死信：无法被消费的消息，称为死信。

如果死信一直留在队列中，会导致一直被消费，却从不消费成功。

所以我们专门开辟了一个来存放死信的队列，叫死信队列（DLX，dead-letter-exchange）。

死信的几种来源：

消息 TTL 过期（time to live，存活时间，可以用在限时支付消息）
队列达到最大长度（队列满了，无法路由到该队列）
消息被拒绝（ basic.reject / basic.nack ），并且 requeue = false

1655097591(1).jpg

环境准备配置

准备 MQ 的队列和环境：

正常交换机
- 正常队列（最长队列 5） ---- 正常消费者，拒绝消息
- ttl 队列（过期时间 60 秒） ---- 没有消费者
死信交换机
- 死信队列

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配置

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<String, Object> args = deadQueueArgs();
        // 队列设置最大长度
        args.put("x-max-length", 5);
        return new Queue("normalQueue", true, false, false, args);
    }

    @Bean
    public Queue ttlQueue() {
        Map<String, Object> 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<String, Object> deadQueueArgs() {
        Map<String, Object> 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	镜像队列

正常队列消费

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<String, Object> 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

消息 TTL 过期队列自动消费

消息的TTL 指的是消息的存活时间，我们可以通过设置消息的TTL或者队列的TTL来实现。

消息的TTL ：对于设置了过期时间属性(expiration)的消息，消息如果在过期时间内没被消费，会过期队列的TTL ：对于设置了过期时间属性(x-message-ttl)的队列，所有路由到这个队列的消息，都会设置上这个过期时间。代码实现：

    /**
     * 消息 TTL, time to live
     */
    @GetMapping("/ttlToDead")
    public String ttlToDead() {

        Map<String, Object> 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 过期后：

1655101560(1).jpg Demo 中只是为了方便，代码中尽量使用消息TTL，不要用队列TTL。

死信队列消费

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<String, Object> 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}
复制代码

SpringBoot+RabbitMQ 实现死信队列

前言