程序员scholar 程序员scholar
首页
  • Java 基础

    • JavaSE
    • JavaIO
    • JavaAPI速查
  • Java 高级

    • JUC
    • JVM
    • Java新特性
    • 设计模式
  • Web 开发

    • Servlet
    • Java网络编程
  • Web 标准

    • HTML
    • CSS
    • JavaScript
  • 前端框架

    • Vue2
    • Vue3
    • Vue3 + TS
    • 微信小程序
    • uni-app
  • 工具与库

    • jQuery
    • Ajax
    • Axios
    • Webpack
    • Vuex
    • WebSocket
    • 第三方登录
  • 后端与语言扩展

    • ES6
    • Typescript
    • node.js
  • Element-UI
  • Apache ECharts
  • 数据结构
  • HTTP协议
  • HTTPS协议
  • 计算机网络
  • Linux常用命令
  • Windows常用命令
  • SQL数据库

    • MySQL
    • MySQL速查
  • NoSQL数据库

    • Redis
    • ElasticSearch
  • 数据库

    • MyBatis
    • MyBatis-Plus
  • 消息中间件

    • RabbitMQ
  • 服务器

    • Nginx
  • Spring框架

    • Spring6
    • SpringMVC
    • SpringBoot
    • SpringSecurity
  • SpringCould微服务

    • SpringCloud基础
    • 微服务之DDD架构思想
  • 日常必备

    • 开发常用工具包
    • Hutoll工具包
    • IDEA常用配置
    • 开发笔记
    • 日常记录
    • 项目部署
    • 网站导航
    • 产品学习
    • 英语学习
  • 代码管理

    • Maven
    • Git教程
    • Git小乌龟教程
  • 运维工具

    • Docker
    • Jenkins
    • Kubernetes
  • 算法笔记

    • 算法思想
    • 刷题笔记
  • 面试问题常见

    • 十大经典排序算法
    • 面试常见问题集锦
关于
GitHub (opens new window)
首页
  • Java 基础

    • JavaSE
    • JavaIO
    • JavaAPI速查
  • Java 高级

    • JUC
    • JVM
    • Java新特性
    • 设计模式
  • Web 开发

    • Servlet
    • Java网络编程
  • Web 标准

    • HTML
    • CSS
    • JavaScript
  • 前端框架

    • Vue2
    • Vue3
    • Vue3 + TS
    • 微信小程序
    • uni-app
  • 工具与库

    • jQuery
    • Ajax
    • Axios
    • Webpack
    • Vuex
    • WebSocket
    • 第三方登录
  • 后端与语言扩展

    • ES6
    • Typescript
    • node.js
  • Element-UI
  • Apache ECharts
  • 数据结构
  • HTTP协议
  • HTTPS协议
  • 计算机网络
  • Linux常用命令
  • Windows常用命令
  • SQL数据库

    • MySQL
    • MySQL速查
  • NoSQL数据库

    • Redis
    • ElasticSearch
  • 数据库

    • MyBatis
    • MyBatis-Plus
  • 消息中间件

    • RabbitMQ
  • 服务器

    • Nginx
  • Spring框架

    • Spring6
    • SpringMVC
    • SpringBoot
    • SpringSecurity
  • SpringCould微服务

    • SpringCloud基础
    • 微服务之DDD架构思想
  • 日常必备

    • 开发常用工具包
    • Hutoll工具包
    • IDEA常用配置
    • 开发笔记
    • 日常记录
    • 项目部署
    • 网站导航
    • 产品学习
    • 英语学习
  • 代码管理

    • Maven
    • Git教程
    • Git小乌龟教程
  • 运维工具

    • Docker
    • Jenkins
    • Kubernetes
  • 算法笔记

    • 算法思想
    • 刷题笔记
  • 面试问题常见

    • 十大经典排序算法
    • 面试常见问题集锦
关于
GitHub (opens new window)
npm

(进入注册为作者充电)

  • 中间件 - RabbitMQ

    • 消息队列 - 介绍
    • RabbitMQ - 介绍
    • RabbitMQ - 安装
    • RabbitMQ - 基础案例
    • RabbitMQ - 应答与发布
    • RabbitMQ - 交换机
    • RabbitMQ - 死信队列
    • RabbitMQ - 延迟队列
    • RabbitMQ - 高级发布确认
      • 1. 发布确认springboot版本
        • 1.1 介绍
        • 1.2 实战
        • 1. RabbitMQ配置类
        • 2. 回调接口
        • 3. 消息生产者
        • 4. 消息消费者
      • 2. 回退消息
        • 2.1 介绍
        • 2.2 实战
        • 1. 修改配置文件
        • 2. 修改回调接口
        • 3. 修改生产者 ProducerController
      • 3. 备份交换机
        • 3.1 介绍
        • 3.2 实战
        • 1. 修改高级确认发布 配置类
        • 2. 报警消费者
    • RabbitMQ - 优先级
    • SpringBoot整合RabbitMQ
  • 消息数据库
  • 中间件 - RabbitMQ
scholar
2023-11-11
目录

RabbitMQ - 高级发布确认

  • 1. 发布确认springboot版本
    • 1.1 介绍
    • 1.2 实战
  • 2. 回退消息
    • 2.1 介绍
    • 2.2 实战
  • 3. 备份交换机
    • 3.1 介绍
    • 3.2 实战

在生产环境中由于一些不明原因,导致 RabbitMQ 重启,在 RabbitMQ 重启期间生产者消息投递失败,导致消息丢失,需要手动处理和恢复。于是,我们开始思考,如何才能进行 RabbitMQ 的消息可靠投递呢?

# 1. 发布确认springboot版本

简单的发布确认机制在应答与签收已经介绍,本内容将介绍整合了 SpringBoot 的发布确认机制。

# 1.1 介绍

首先发布消息后进行备份在缓存里,如果消息成功发布确认到交换机,则从缓存里删除该消息,如果没有成功发布,则设置一个定时任务,重新从缓存里获取消息发布到交换机,直到成功发布到交换机。

确认机制图例:

image-20211112000502762

# 1.2 实战

一个交换机:confirm.exchange,一个队列:confirm.queue,一个消费者:confirm.consumer

其中交换机类型时 direct,与队列关联的 routingKey 是 key1

代码架构图:

image-20211112000539340

在配置文件当中需要添加:









 

server:
  port: 8808
spring:
  rabbitmq:
    host: 112.74.169.231       # RabbitMQ服务器的地址
    port: 5672                 # RabbitMQ服务监听的端口
    username: admin            # 用于连接RabbitMQ的用户名
    password: 123456           # 用于连接RabbitMQ的密码
    publisher-confirm-type: correlated # 发布确认模式类型
1
2
3
4
5
6
7
8
9
  • none:禁用发布确认模式。这是默认值,表示不进行任何发布确认处理。
  • correlated:启用发布确认模式,并且在消息成功发布到交换器后会触发相应的回调方法。适用于需要对消息投递结果进行处理的场景。
  • simple:这个选项允许在消息成功发布后,通过rabbitTemplate.waitForConfirms或waitForConfirmsOrDie方法等待消息代理(broker)返回发送结果。这种模式下,如果waitForConfirmsOrDie返回false,则会导致当前通道(channel)关闭,之后无法继续发送消息到消息代理。

# 1. RabbitMQ配置类

声明交换机和队列,并且将交换机和队列进行绑定

import org.springframework.amqp.core.*;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * RabbitMQ高级发布确认配置类。
 * 用于声明交换机、队列,并将它们绑定。
 */
@Configuration
public class ConfirmConfig {

    // 交换机名称
    public static final String CONFIRM_EXCHANGE_NAME = "confirm.exchange";
    // 队列名称
    public static final String CONFIRM_QUEUE_NAME = "confirm.queue";

    /**
     * 声明Direct类型的交换机。
     * Direct交换机根据routingKey完全匹配来路由消息。
     * @return 配置的Direct交换机
     */
    @Bean("confirmExchange")
    public DirectExchange confirmExchange() {
        // 创建并返回一个新的DirectExchange
        return new DirectExchange(CONFIRM_EXCHANGE_NAME);
    }

    /**
     * 声明持久化队列。
     * @return 配置的队列
     */
    @Bean("confirmQueue")
    public Queue confirmQueue() {
        // QueueBuilder用于构建队列,durable表示队列是持久化的
        return QueueBuilder.durable(CONFIRM_QUEUE_NAME).build();
    }

    /**
     * 声明队列和交换机的绑定关系。
     * 使用routingKey为"key1"将队列和交换机绑定。
     * @param queue 通过Qualifier指定注入的队列bean
     * @param exchange 通过Qualifier指定注入的交换机bean
     * @return 配置的绑定对象
     */
    @Bean
    public Binding queueBinding(@Qualifier("confirmQueue") Queue queue, 
                                 @Qualifier("confirmExchange") DirectExchange exchange) {
        // BindingBuilder用于构建绑定关系,with指定routingKey
        return BindingBuilder.bind(queue).to(exchange).with("key1");
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# 2. 回调接口

消息生产者发布消息后的回调接口,只要生产者发布消息,交换机不管是否收到消息,都会调用该类的 confirm 方法

import lombok.extern.slf4j.Slf4j;
import org.springframework.amqp.rabbit.connection.CorrelationData;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.stereotype.Component;

/**
 * 实现RabbitTemplate.ConfirmCallback接口,用于消息发布后的确认回调。
 * 这里的回调指的是消息是否成功送达交换机。
 */
@Component  // 标注为Spring组件,使Spring能够管理这个类的实例
@Slf4j  // Lombok注解,为类提供一个log属性,用于日志记录
public class MyCallBack implements RabbitTemplate.ConfirmCallback {
    
    /**
     * 交换机确认回调方法。
     * @param correlationData 消息的相关数据,通常包含消息的唯一标识。
     * @param ack             确认标志,true表示交换机已成功接收消息,false表示接收失败。
     * @param cause           接收失败的原因,当ack为true时,cause为null。
     */
    @Override
    public void confirm(CorrelationData correlationData, boolean ack, String cause) {
        // 获取消息唯一标识
        String id = correlationData != null ? correlationData.getId() : "";
        
        // 判断交换机是否成功接收消息
        if (ack) {
            // 如果成功,记录日志信息
            log.info("交换机已经收到 id 为:{}的消息", id);
        } else {
            // 如果失败,记录日志信息,包括失败的原因
            log.info("交换机还未收到 id 为:{}的消息,失败原因:{}", id, cause);
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

# 3. 消息生产者

在controller定义了一个方法,它充当消息生产者的角色,用于向RabbitMQ发送消息。

import lombok.extern.slf4j.Slf4j;
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.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.PostConstruct;

/**
 * 消息生产者控制器,用于演示高级消息发布。
 */
@RestController  
@RequestMapping("/confirm")  
@Slf4j  
public class ProducerController {
    // 交换机名称
    public static final String CONFIRM_EXCHANGE_NAME = "confirm.exchange";
    
    @Autowired
    private RabbitTemplate rabbitTemplate; 
    
    @Autowired
    private MyCallBack myCallBack;  // 自定义的消息确认回调类
    
    /**
     * 在依赖注入完成后设置RabbitTemplate的确认回调对象。
     */
    @PostConstruct
    public void init() {
        // 设置RabbitTemplate的确认回调对象为myCallBack
        rabbitTemplate.setConfirmCallback(myCallBack);
    }

    /**
     * 通过HTTP GET请求发送消息,演示消息回调和退回。
     * @param message 通过URL路径传递的消息内容
     */
    @GetMapping("/sendMessage/{message}")
    public void sendMessage(@PathVariable String message) {
        // 创建关联数据对象,携带消息的唯一标识
        CorrelationData correlationData1 = new CorrelationData("1");
        String routingKey = "key1";
        // 发送消息到交换机,并指定路由键
        rabbitTemplate.convertAndSend(CONFIRM_EXCHANGE_NAME, routingKey, message + routingKey, correlationData1);
        log.info(routingKey + " 发送消息内容:{}", message + routingKey);

        // 演示发送另一条消息
        CorrelationData correlationData2 = new CorrelationData("2");
        routingKey = "key2";
        rabbitTemplate.convertAndSend(CONFIRM_EXCHANGE_NAME, routingKey, message + routingKey, correlationData2);
        log.info(routingKey + " 发送消息内容:{}", message + routingKey);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

# 4. 消息消费者

定义了一个RabbitMQ消息消费者,它监听confirm.queue队列中的消息。当有消息到达这个队列时,Spring Boot应用中的RabbitListener注解自动捕获这些消息,并调用相应的方法进行处理。

import lombok.extern.slf4j.Slf4j;
import org.springframework.amqp.core.Message;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;

/**
 * 消费者类,用于监听并消费RabbitMQ队列中的消息。
 */
@Component  
@Slf4j  
public class ConfirmConsumer {

    // 静态常量,代表监听的队列名称
    public static final String CONFIRM_QUEUE_NAME = "confirm.queue";

    /**
     * 使用@RabbitListener注解监听指定的RabbitMQ队列。
     * 当队列中有消息时,Spring会调用这个方法,并将消息作为参数传递给它。
     * 
     * @param message 从队列中接收到的消息对象,包含了消息的详细信息。
     */
    @RabbitListener(queues = CONFIRM_QUEUE_NAME)
    public void receiveMsg(Message message) {
        // 将消息体转换为字符串
        String msg = new String(message.getBody());
        // 使用log记录接收到的消息
        log.info("接受到队列 confirm.queue 的消息:{}", msg);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

访问:http://localhost:8808/confirm/sendMessage/可乐 (opens new window)

结果分析:

image-20211112173526575

可以看到,发送了两条消息,第一条消息的 RoutingKey 为 "key1",第二条消息的 RoutingKey 为 "key2",两条消息都成功被交换机接收,也收到了交换机的确认回调,但消费者只收到了一条消息,因为第二条消息的 RoutingKey 与队列的 BindingKey 不一致,也没有其它队列能接收这个消息,所有第二条消息被直接丢弃了。

丢弃的消息交换机是不知道的,需要解决告诉生产者消息传送失败

# 2. 回退消息

在RabbitMQ中,回退消息(Returned Message)是指无法被路由到指定队列的消息。通过配置和使用RabbitTemplate.ReturnsCallback接口,可以有效地处理这些无法路由的消息,确保消息不会在传输过程中默默丢失。

# 2.1 介绍

获取回退的消息,首先在配置文件开启该功能,然后需要自定义类实现 RabbitTemplate.ReturnsCallback 接口,并且初始化时,使用该自定义类作为回退消息的处理类,同时开启 Mandatory,设置为 true

在启动开启 Mandatory,或者在代码里手动开启 Mandatory 参数,或者都开启😸

配置类文件开启:新版和旧版Spring Boot对应的配置方式略有不同

# 新版Spring Boot配置
spring:
  rabbitmq:
    template:
      mandatory: true
      
# 旧版Spring Boot配置
spring:
  rabbitmq:
    mandatory: true
1
2
3
4
5
6
7
8
9
10

也可以在代码中直接设置mandatory参数:

@Autowired
private RabbitTemplate rabbitTemplate;

public void configureRabbitTemplate() {
    rabbitTemplate.setMandatory(true);
}
1
2
3
4
5
6

在仅开启了生产者确认机制的情况下,交换机接收到消息后,会直接给消息生产者发送确认消息,如果发现该消息不可路由,那么消息会被直接丢弃,此时生产者是不知道消息被丢弃这个事件的。

那么如何让无法被路由的消息帮我想办法处理一下?最起码通知我一声,我好自己处理啊。通过设置 mandatory 参数可以在当消息传递过程中不可达目的地时将消息返回给生产者。

开启Mandatory参数的作用

为了让生产者知道其发送的消息是否成功路由,需要开启RabbitMQ的Mandatory参数。当Mandatory参数设置为true时,如果交换机根据路由键找不到匹配的队列,那么RabbitMQ会将消息返回给生产者;如果未设置或设置为false,则消息会被直接丢弃(如果未配置死信队列)

# 2.2 实战

# 1. 修改配置文件










 
 
 

server:
  port: 8808  # 应用服务的端口
spring:
  rabbitmq:
    host: 112.74.169.231  # RabbitMQ服务器的主机地址
    port: 5672  # RabbitMQ服务器的端口
    username: admin  # 连接RabbitMQ服务器的用户名
    password: 123456  # 连接RabbitMQ服务器的密码
    publisher-confirm-type: correlated  # 启用发布者确认机制
    publisher-returns: true  # 开启消息回退功能
    template:
      mandatory: true  # 设置消息为强制性的,未能路由的消息将被返回给生产者
1
2
3
4
5
6
7
8
9
10
11
12
  • spring.rabbitmq.publisher-confirm-type: 设置发布确认类型。correlated表示开启发布确认机制,并在消息被交换机接收后触发回调方法。
  • spring.rabbitmq.publisher-returns: 设置为true以开启回退消息功能。当消息无法被路由到任何一个队列时,消息将被返回给生产者。
  • spring.rabbitmq.template.mandatory: 设置为true使所有消息成为强制性的,即如果消息无法路由到队列,将触发ReturnsCallback。

# 2. 修改回调接口

为了处理无法被路由到任何队列的消息,可以通过实现RabbitTemplate.ReturnsCallback接口(或RabbitTemplate.ReturnCallback,取决于Spring AMQP的版本)来接收这些被退回的消息。

对于较新版本的Spring AMQP,使用ReturnsCallback接口:










































 
 
 
 
 
 
 
 
 
 
 
 
 


import lombok.extern.slf4j.Slf4j;
import org.springframework.amqp.core.Message;
import org.springframework.amqp.rabbit.connection.CorrelationData;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.stereotype.Component;

/**
 * 实现RabbitMQ消息发布后的确认回调和无法路由消息的回退处理。
 */
@Component  // 表示该类为Spring组件,由Spring管理
@Slf4j  // Lombok注解,提供日志功能
public class MyCallBack implements RabbitTemplate.ConfirmCallback, RabbitTemplate.ReturnsCallback {
    /**
     * 当消息成功或失败送达交换机时,会触发此回调方法。
     *
     * @param correlationData 消息的相关数据,包括消息的唯一ID。
     * @param ack             表示交换机是否接收到消息,true为成功,false为失败。
     * @param cause           交换机未成功接收消息的原因描述。
     */
    @Override
    public void confirm(CorrelationData correlationData, boolean ack, String cause) {
        // 获取消息的唯一标识
        String id = correlationData != null ? correlationData.getId() : "";
        if(ack) {
            // 如果消息成功送达交换机
            log.info("交换机已经收到 id 为:{}的消息", id);
        } else {
            // 如果消息未能成功送达交换机
            log.info("交换机还未收到 id 为:{}的消息,原因:{}", id, cause);
        }
    }

    /**
     * 当消息无法被路由到任何队列时,会触发此回调方法。
     *
     * @param message    无法路由的消息内容。
     * @param replyCode  错误码,表示消息退回的原因。
     * @param replyText  错误文本,具体的退回原因描述。
     * @param exchange   消息尝试投递的交换机。
     * @param routingKey 消息使用的路由键。
     */
    @Override
    public void returnedMessage(ReturnedMessage returned) {
        // 从返回信息中提取详细内容
        Message message = returned.getMessage();
        int replyCode = returned.getReplyCode();
        String replyText = returned.getReplyText();
        String exchange = returned.getExchange();
        String routingKey = returned.getRoutingKey();

        // 记录无法路由的消息详情
        log.error("消息:{},被交换机 {} 退回,原因:{},路由key:{}, 编码:{}",
                  new String(message.getBody()), exchange, replyText, routingKey, replyCode);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

对于使用较旧版本的Spring AMQP,可以实现RabbitTemplate.ReturnCallback接口来处理无法路由到任何队列的消息。

import lombok.extern.slf4j.Slf4j;
import org.springframework.amqp.core.Message;
import org.springframework.amqp.rabbit.connection.CorrelationData;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.stereotype.Component;

/**
 * 实现RabbitMQ消息发布后的确认回调和无法路由消息的回退处理。
 */
@Component  
@Slf4j  
public class MyCallBack implements RabbitTemplate.ConfirmCallback, RabbitTemplate.ReturnCallback {
    /**
     * 当消息成功或失败送达交换机时,会触发此回调方法。
     *
     * @param correlationData 消息的相关数据,包括消息的唯一ID。
     * @param ack             表示交换机是否接收到消息,true为成功,false为失败。
     * @param cause           交换机未成功接收消息的原因描述。
     */
    @Override
    public void confirm(CorrelationData correlationData, boolean ack, String cause) {
        // 获取消息的唯一标识
        String id = correlationData != null ? correlationData.getId() : "";
        if(ack) {
            // 如果消息成功送达交换机
            log.info("交换机已经收到 id 为:{}的消息", id);
        } else {
            // 如果消息未能成功送达交换机
            log.info("交换机还未收到 id 为:{}的消息,原因:{}", id, cause);
        }
    }

    /**
     * 当消息无法被路由到任何队列时的回调方法。
     *
     * @param message    发送的消息对象,包含消息内容和属性。
     * @param replyCode  退回的错误码,表示消息退回的原因。
     * @param replyText  退回的错误文本,描述消息为何被退回。
     * @param exchange   消息尝试发送到的交换机。
     * @param routingKey 消息使用的路由键。
     */
    @Override
    public void returnedMessage(Message message, int replyCode, String replyText, String exchange, String routingKey) {
        // 日志记录无法路由的消息详情
        log.error("消息:{},被交换机 {} 退回,原因:{},路由key:{}, 错误码:{}",
                new String(message.getBody()), exchange, replyText, routingKey, replyCode);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
  • ReturnedMessage returned: 这是Spring AMQP库提供的一个包装类,其中包含了被退回消息的所有相关信息,例如消息内容、回复编码、回复文本、使用的交换机和路由键。
  • returned.getMessage().getBody(): 获取退回消息的主体内容。这是一个字节数组,通常需要转换成字符串或相应的数据格式以便读取。
  • returned.getExchange(): 返回消息被退回时使用的交换机名称。
  • returned.getReplyText(): 提供了消息被退回的原因描述。
  • returned.getRoutingKey(): 显示了消息被退回时使用的路由键。
  • returned.getReplyCode(): 返回了与消息被退回相关的回复编码。这个编码可以提供额外的信息或者指明为什么消息无法被路由。

# 3. 修改生产者 ProducerController

import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import lombok.extern.slf4j.Slf4j;

import javax.annotation.PostConstruct;

@RestController 
@RequestMapping("/confirm") 
@Slf4j 
public class ProducerController {
    
    @Autowired
    private RabbitTemplate rabbitTemplate;

    @Autowired
    private MyCallBack myCallBack; // 自定义的回调处理类
    
    /**
     * 初始化方法,用于配置RabbitTemplate。
     */
    @PostConstruct // 此注解确保此方法在依赖注入完成后被自动调用
    public void init() {
        // 设置消息确认回调处理,以便确认消息是否成功发送到交换机
        rabbitTemplate.setConfirmCallback(myCallBack);
        
        /**
         * 设置mandatory标志为true,这确保如果消息不能被路由到任何队列,
         * 那么消息会被返回给生产者(而不是直接被丢弃)。
         */
        rabbitTemplate.setMandatory(true);

        // 设置消息返回回调处理,以便处理无法被路由到队列的消息
        rabbitTemplate.setReturnCallback(myCallBack);
    }
    // 其他方法......
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

打开浏览器访问地址:http://localhost:8808/confirm/sendMessage/可乐 (opens new window)

image-20240328013134380

可以看到最后打印的结果中,由于我们故意将rootkey改错了,所以消息被退回给交换机了。

# 3. 备份交换机

# 3.1 介绍

理这些无法路由的消息是很不优雅的做法,特别是当生产者所在的服务有多台机器的时候,手动复制日志会更加麻烦而且容易出错。而且设置 mandatory 参数会增加生产者的复杂性,需要添加处理这些被退回的消息的逻辑。如果既不想丢失消息,又不想增加生产者的复杂性,该怎么做呢?

前面在设置死信队列的文章中,我们提到,可以为队列设置死信交换机来存储那些处理失败的消息,可是这些不可路由消息根本没有机会进入到队列,因此无法使用死信队列来保存消息。 在 RabbitMQ 中,有一种备份交换机的机制存在,可以很好的应对这个问题。

什么是备份交换机呢?

备份交换机可以理解为 RabbitMQ 中交换机的“备胎”,当我们为某一个交换机声明一个对应的备份交换机时,就是为它创建一个备胎,当交换机接收到一条不可路由消息时,将会把这条消息转发到备份交换机中,由备份交换机来进行转发和处理,通常备份交换机的类型为 Fanout ,这样就能把所有消息都投递到与其绑定的队列中,然后我们在备份交换机下绑定一个队列,这样所有那些原交换机无法被路由的消息,就会都进 入这个队列了。当然,我们还可以建立一个报警队列,用独立的消费者来进行监测和报警。

# 3.2 实战

需要一个备份交换机 backup.exchange,类型为 fanout,该交换机发送消息到队列 backup.queue 和 warning.queue

代码架构图:

image-20211112002641439

# 1. 修改高级确认发布 配置类

import org.springframework.amqp.core.*;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * RabbitMQ高级发布确认与备份交换机配置类。
 */
@Configuration
public class ConfirmConfig {
    // 主交换机、备份交换机和队列的名称常量
    public static final String CONFIRM_EXCHANGE_NAME = "confirm.exchange";
    public static final String CONFIRM_QUEUE_NAME = "confirm.queue";
    // 备份交换机及其队列
    public static final String BACKUP_EXCHANGE_NAME = "backup.exchange";
    public static final String BACKUP_QUEUE_NAME = "backup.queue";
    public static final String WARNING_QUEUE_NAME = "warning.queue";

    /**
     * 声明主业务交换机,配置备份交换机
     */
    @Bean("confirmExchange")
    public DirectExchange confirmExchange() {
        // 创建Direct类型的交换机,并配置备份交换机的名称
        return ExchangeBuilder.directExchange(CONFIRM_EXCHANGE_NAME)
                .durable(true)
                .withArgument("alternate-exchange", BACKUP_EXCHANGE_NAME)
                .build();
    }

    /**
     * 声明主业务队列
     */
    @Bean("confirmQueue")
    public Queue confirmQueue() {
        return QueueBuilder.durable(CONFIRM_QUEUE_NAME).build();
    }

    /**
     * 绑定主业务队列与交换机
     */
    @Bean
    public Binding queueBinding(@Qualifier("confirmQueue") Queue queue, 
                                 @Qualifier("confirmExchange") DirectExchange exchange) {
        return BindingBuilder.bind(queue).to(exchange).with("key1");
    }

    /**
     * 声明备份交换机
     */
    @Bean("backupExchange")
    public FanoutExchange backupExchange() {
        return new FanoutExchange(BACKUP_EXCHANGE_NAME);
    }

    /**
     * 声明备份队列
     */
    @Bean("backupQueue")
    public Queue backupQueue() {
        return QueueBuilder.durable(BACKUP_QUEUE_NAME).build();
    }

    /**
     * 声明警告队列
     */
    @Bean("warningQueue")
    public Queue warningQueue() {
        return QueueBuilder.durable(WARNING_QUEUE_NAME).build();
    }

    /**
     * 绑定备份队列与备份交换机
     */
    @Bean
    public Binding backupBinding(@Qualifier("backupQueue") Queue queue, 
                                 @Qualifier("backupExchange") FanoutExchange backupExchange) {
        return BindingBuilder.bind(queue).to(backupExchange);
    }

    /**
     * 绑定警告队列与备份交换机
     */
    @Bean
    public Binding warningBinding(@Qualifier("warningQueue") Queue queue, 
                                  @Qualifier("backupExchange") FanoutExchange backupExchange) {
        return BindingBuilder.bind(queue).to(backupExchange);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

# 2. 报警消费者

定义了一个消费者类WarningConsumer,专门用于监听并处理RabbitMQ中备份交换机下的warning.queue队列中的消息。这些消息是由于主交换机无法路由到任何队列而被转发到备份交换机的,该消费者类的作用是从警告队列接收这些消息并进行处理。

import lombok.extern.slf4j.Slf4j;
import org.springframework.amqp.core.Message;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;

/**
 * 报警消费者类,负责处理不能被路由的消息。
 */
@Component
@Slf4j 
public class WarningConsumer {
    // 警告队列的名称
    public static final String WARNING_QUEUE_NAME = "warning.queue";

    /**
     * 使用@RabbitListener注解监听警告队列。
     * 当警告队列中有消息时,此方法会被自动调用。
     *
     * @param message 从队列中接收到的消息对象
     */
    @RabbitListener(queues = WARNING_QUEUE_NAME)
    public void receiveWarningMsg(Message message) {
        // 将消息体转换为字符串
        String msg = new String(message.getBody());
        // 使用日志记录下接收到的不能被路由的消息
        log.error("报警发现不可路由消息:{}", msg);
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

由于之前写过 confirm.exchange 交换机,当更改配置了,需要删掉,不然会报以下错误:

image-20211112180036082

打开浏览器访问地址:http://localhost:8808/confirm/sendMessage/可乐 (opens new window)

image-20240328035059198

总结

  • 交换机的声明是幂等的:在RabbitMQ中,重复声明同一个交换机(名称、类型、参数完全相同)不会有任何副作用,但如果尝试以不同的参数重新声明一个已存在的交换机,会导致错误。
  • 备份交换机优先级高:当mandatory参数和备份交换机同时启用时,备份交换机的优先级更高。无法路由的消息将被发送到备份交换机,而不是触发ReturnCallback。
  • 监控和告警:通过监控备份队列和警告队列中的消息,可以及时发现并处理消息路由失败的情况,从而提高系统的可靠性和稳定性。

在实际应用中,可以根据不同的业务场景设计备份交换机和队列的使用策略。例如,可以将不能立即处理的消息暂存到备份队列中,待系统资源充足或条件满足时再进行处理;或者将这些消息用于系统监控和告警,及时发现潜在的问题。

编辑此页 (opens new window)
上次更新: 2024/12/28, 18:32:08
RabbitMQ - 延迟队列
RabbitMQ - 优先级

← RabbitMQ - 延迟队列 RabbitMQ - 优先级→

Theme by Vdoing | Copyright © 2019-2025 程序员scholar
  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式