Spring Boot整合RabbitMQ极简教程

一、消息队列能解决什么问题？

• 异步处理：解耦耗时操作（如发短信、日志记录）
• 流量削峰：应对突发请求，避免系统过载
• 应用解耦：服务间通过消息通信，降低依赖

---

二、快速整合RabbitMQ

1. 环境准备

• 安装RabbitMQ（推荐Docker一键部署）：

  docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:management  
  

• 访问管理界面：http://localhost:15672（账号/密码：guest/guest）

2. Spring Boot项目配置

① 添加依赖

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

② 配置连接信息

# application.yml  
spring:  rabbitmq:  host: localhost  port: 5672  username: guest  password: guest  virtual-host: /  

---

三、核心代码实现

1. 生产者（发送消息）

@Component  
public class MsgProducer {  @Autowired  private AmqpTemplate amqpTemplate;  // 发送到指定队列  public void send(String message) {  amqpTemplate.convertAndSend("demo_queue", message);  System.out.println("消息已发送: " + message);  }  
}  

2. 消费者（接收消息）

@Component  
public class MsgConsumer {  // 监听指定队列  @RabbitListener(queues = "demo_queue")  public void handle(String message) {  System.out.println("收到消息: " + message);  }  
}  

3. 自动创建队列（可选）

@Configuration  
public class RabbitConfig {  // 声明队列（若不存在则自动创建）  @Bean  public Queue demoQueue() {  return new Queue("demo_queue");  }  
}  

---

四、测试消息收发

@SpringBootTest  
class DemoApplicationTests {  @Autowired  private MsgProducer msgProducer;  @Test  void testSend() {  msgProducer.send("Hello RabbitMQ!");  }  
}  

控制台输出：

消息已发送: Hello RabbitMQ!  
收到消息: Hello RabbitMQ!  

---

五、扩展：常用注解与配置

注解/配置	说明
@RabbitListener	监听队列或交换机消息
@RabbitHandler	处理消息的方法注解
@Exchange + @Binding	声明交换机与队列绑定关系
spring.rabbitmq.listener.simple.retry.enabled=true	启用消费失败重试

---

六、常见问题

1. 消息未消费

   • 检查队列名是否一致
   • 消费者是否添加了@Component注解
   • 确认RabbitMQ服务是否正常运行

2. 连接失败

   • 检查application.yml中的host、port、账号密码
   • 防火墙是否开放5672端口

3. 消息重复消费

   • 启用消费者幂等处理
   • 使用@RabbitListener(id = "唯一ID")

---

七、其他MQ整合（简要）

MQ类型	依赖配置	核心注解
Kafka	spring-kafka	@KafkaListener
RocketMQ	rocketmq-spring-boot-starter	@RocketMQMessageListener

---

八、总结

通过Spring Boot整合RabbitMQ只需三步：

1. 加依赖：spring-boot-starter-amqp
2. 配连接：application.yml中设置RabbitMQ地址
3. 用注解：@RabbitListener实现消息监听

官方文档：Spring AMQP Reference