Spring Boot 中整合 RabbitMQ（测试 + 部署上线最完整指南）

最新推荐文章于 2025-04-17 17:44:03 发布

一只蜗牛儿

最新推荐文章于 2025-04-17 17:44:03 发布

阅读量2.5k

点赞数 10

文章标签： java-rabbitmq spring boot rabbitmq

本文链接：https://blog.csdn.net/qq_42978535/article/details/142654003

版权

RabbitMQ 是一个流行的开源消息代理，广泛用于构建分布式系统和微服务架构。本文将详细介绍如何在 Spring Boot 中整合 RabbitMQ，包括配置、测试和部署上线的完整流程。

1. RabbitMQ 简介

RabbitMQ 是一个开源的消息中间件，支持多种消息协议。它基于 AMQP（高级消息队列协议）实现。RabbitMQ 的主要特点包括：

可靠性：消息持久化，支持事务。
灵活性：支持多种消息路由方式。
可扩展性：支持集群和高可用性部署。
管理界面：提供 Web 管理界面，方便监控和管理。

2. 环境准备

2.1 安装 RabbitMQ

如果你尚未安装 RabbitMQ，可以通过以下步骤在本地安装：

安装 Erlang（RabbitMQ 的依赖）：
```
sudo apt-get install erlang
```

下载并安装 RabbitMQ：

# 下载 RabbitMQ 安装包
wget https://github.com/rabbitmq/rabbitmq-server/releases/download/v3.10.0/rabbitmq-server-generic-unix-3.10.0.tar.xz
# 解压安装包
tar -xvf rabbitmq-server-generic-unix-3.10.0.tar.xz
cd rabbitmq_server-3.10.0/sbin
# 启动 RabbitMQ
./rabbitmq-server

启用管理插件（可选）：

./rabbitmq-plugins enable rabbitmq_management

访问管理界面：
在浏览器中访问 http://localhost:15672，默认用户名和密码为 guest。

2.2 创建 Spring Boot 项目

使用 Spring Initializr 创建一个新的 Spring Boot 项目，选择以下依赖：

Spring Web
Spring for RabbitMQ

3. Spring Boot 集成 RabbitMQ

3.1 添加依赖

在 pom.xml 中添加 RabbitMQ 的依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-amqp</artifactId>
</dependency>

3.2 配置 RabbitMQ

在 application.yml 中添加 RabbitMQ 的配置：

spring:
  rabbitmq:
    host: localhost
    port: 5672
    username: guest
    password: guest

3.3 创建消息发送者

创建一个消息发送者类 MessageSender：

import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class MessageSender {
    
    @Autowired
    private RabbitTemplate rabbitTemplate;

    public void send(String message) {
        rabbitTemplate.convertAndSend("myQueue", message);
        System.out.println("Sent: " + message);
    }
}

3.4 创建消息接收者

创建一个消息接收者类 MessageReceiver：

import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Component;

@Component
public class MessageReceiver {

    @RabbitListener(queues = "myQueue")
    public void receive(String message) {
        System.out.println("Received: " + message);
    }
}

4. 测试 RabbitMQ

创建一个控制器 TestController 来测试消息发送：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class TestController {

    @Autowired
    private MessageSender messageSender;

    @GetMapping("/send")
    public String sendMessage() {
        messageSender.send("Hello, RabbitMQ!");
        return "Message sent!";
    }
}