【实战指南】Spring Boot项目：一键式RabbitMQ集成与可靠性配置

Springboot项目中快速引入Rabbit MQ通用做法

由来

本篇是在做BI项目时尝试引入MQ来优化项目时发现，MQ引入到项目中做法比较类似。变的只是谁发消息给谁，谁去监听消息。至于MQ的可靠性（比如生产者可靠性、消费者可靠性、消息可靠性）都是通过固定参数进行配置。
因此将引入MQ到BI项目的过程抽象出来，变成通用的方法～

引入MQ目的

砍掉耗时久的业务，缩短单个业务时间，监听者异步执行耗时久任务
做完之后，你可以完成springboot项目中MQ基本配置，并且MQ具有一定可靠性~

步骤

1. 在Application中配置MQ
   • 生产者确认机制，重连机制、消费者能者多劳、确认机制、失败消息处理策略
   • 保证可靠性（配备了生产者确认，重连、消费者能者多劳，确认机制，失败消息处理策略）
     yml配置

   spring:
   	rabbitmq:
   	  # 连接信息
   	  host: xxx # 你的IP地址
   	  port: 5672
     	# 用户相关信息建议在rabbitMQ中设置好
   	  virtual-host: /bi # 可在UI界面创建独属项目的虚拟机与用户名
   	  username: xxx # 用户名
   	  password: xxx # 密码
   	  connection-timeout: 200ms # max waited time
   	
   	  # 生产者（消息发送者）
   	  # 生产者确认机制 - 默认取消，消耗性能
   	  publisher-confirm-type: none
   	  publisher-returns: false
   	  template:
   	    # 生产者重连机制
   	    retry:
   	      enabled: true
   	      initial-interval: 1000ms
   	      multiplier: 1
   	      max-attempts: 3
   	
   	  # 消费者（监听者）
   	  listener:
   	    simple:
   	      prefetch: 1 # （能者多劳）每次只能获取一条信息，处理完才能获取下一条
   	      acknowledge-mode: auto # 消费者确认 - 自动模式
   	      retry:
   	        enabled: true # 失败消息处理策略
   

   失败者消息处理策略实现 - 消息发到error交换机

   	/**
   	 * 失败者消息处理策略实现
   	 */
   	@Bean
   	public MessageRecoverer messageRecoverer(RabbitTemplate rabbitTemplate){
   	    return new RepublishMessageRecoverer(rabbitTemplate, BI_ERROR_EXCHANGE, BI_ERROR_ROUTING_KEY);
   	}
   

2. 统一确定并定义业务的有关MQ常量 MQConstant.java
   • 交换机、队列、Key
   • error交换机，队列，Key（按需设置）
3. 开始初始化
   a. 业务MQ 与 error交换机MQ，并绑定关系（选一个就行，推荐第二种）
   用Bean方法创建

   @Configuration
   public class ErrorConfiguration {
   
       @Bean
       public Queue errorQueue() {
           return QueueBuilder.durable(BI_ERROR_QUEUE).build();
       }
   
       @Bean
       public DirectExchange errorExchange() {
           return ExchangeBuilder.directExchange(BI_ERROR_EXCHANGE).build();
       }
   
       @Bean
       public Binding errorBinding() {
           return BindingBuilder.bind(errorQueue()).to(errorExchange()).with(BI_ERROR_ROUTING_KEY);
       }
   
   }
   

   直接在@RabbitListener注解中定义并绑定

   	@RabbitListener(bindings = @QueueBinding(
           // 队列：
           // name - 队列名字
           // durable - 队列持久化，不会随着MQ关闭而消失
           // arguments：使队列为Lazy queue将消息尽快写入磁盘
           value = @Queue(
                   name = BI_QUEUE_NAME,
                   durable = "true",
                   arguments = @Argument(name = "x-queue-mode", value = "lazy")),
           // 交换机:指定交换机的名字与类型(默认direct)
           exchange = @Exchange(name = BI_EXCHANGE_NAME, type = ExchangeTypes.DIRECT),
           // 按交换机类型(Direct、Topic),设置Key
           key = BI_ROUTING_KEY
   ))
   public void receiveMessage(String msg) {
   

   b. JSON消息转换器（替换掉原生的JDK）

   	 /**
   	 * 消息转换器
   	 * @return
   	 */
   	@Bean
   	public MessageConverter messageConverter(){
   	    return new Jackson2JsonMessageConverter();
   	}
   

   3. 编写业务代码（根据实际业务）
      a. 发送信息：砍掉耗时久的业务，变成发送消息
      ⅰ. 选用唯一性的信息，如id
      ⅱ. 确定好消息的数据类型
      b. 监听信息：添加监听者，执行耗时久的业务。
      ⅰ. 需要根据实际情况修改代码
      ⅱ. 可以根据业务实际情况使：业务幂等性

   	@RabbitListener(bindings = @QueueBinding(
           // 队列：
           // name - 队列名字
           // durable - 队列持久化，不会随着MQ关闭而消失
           // arguments：使队列为Lazy queue将消息尽快写入磁盘
           value = @Queue(
                   name = BI_QUEUE_NAME,
                   durable = "true",
                   arguments = @Argument(name = "x-queue-mode", value ="lazy")),
           // 交换机:指定交换机的名字与类型(默认direct)
           exchange = @Exchange(name = BI_EXCHANGE_NAME, type = ExchangeTypes.DIRECT),
           // 按交换机类型(Direct、Topic),设置Key
           key = BI_ROUTING_KEY
   ))
   public void receiveMessage(Long chatId) {
       // 0. 业务幂等性判断 - 基于乐观锁改造
       boolean update = chartService.lambdaUpdate()
               .set(Chart::getStatus, RUNNING_STATUS)
               .eq(Chart::getId, chatId)
               .eq(Chart::getStatus, WAIT_STATUS)
               .update();
       if (!update) {
           handleChartUpdateError(chatId, "该图表正在生成中！请耐心等待");
           return;
       }
   

   当然，还可以对其进行拓展，比如对error队列进行监听，针对错误消息进行特殊业务处理等等~
   至此之后，MQ基本操作以及配置完毕~并且MQ可靠性相对高。

总结

在Spring Boot项目中快速集成RabbitMQ以增强系统性能和可靠性，主要涉及以下几个关键步骤：

1.引入MQ的目的

• 业务优化：通过异步处理长时间运行的任务，减少单个业务请求的响应时间。
• 可靠性提升：确保消息传递的稳定性和准确性，即使在网络不稳定或系统故障的情况下。

2.配置要点

• 连接信息：在application.yml中配置RabbitMQ服务器的连接细节，包括主机、端口、虚拟主机、用户名、密码及连接超时时间。
• 生产者确认机制：启用确认机制，配置重试策略，确保消息成功发布。
• 消费者策略：实施“能者多劳”原则，即每次仅处理一条消息，以及自动确认和失败消息重试策略。
• 失败消息处理：定义失败消息的重发逻辑，例如重定向至错误交换机。

3.实现过程

1. 配置MQ：在application.yml中设置RabbitMQ相关参数，包括连接信息、生产者和消费者的配置。
2. 定义MQ常量：统一定义交换机、队列和路由键等MQ相关常量，便于维护和扩展。
3. 初始化MQ组件：
   • 创建错误队列、交换机和绑定关系。
   • 使用Bean方式或直接在@RabbitListener注解中定义队列、交换机和绑定关系。
   • 替换默认的消息转换器为JSON消息转换器。
4. 编写业务代码：
   • 发送端：使用唯一标识符发送消息，并确保数据类型的正确性。
   • 接收端：监听队列，处理耗时任务，实现业务幂等性确保数据一致性。

4.扩展功能

• 监听错误队列，对错误消息进行特殊处理，进一步完善系统健壮性。

通过上述步骤，可以实现在Spring Boot项目中高效、可靠地使用RabbitMQ作为消息中间件，优化业务流程并提升系统整体性能。