消息队列 / 系统课时

Spring AMQP 基础配置

Spring AMQP 基础配置

Spring Boot 可以把 RabbitMQ 的连接管理、消息模板和拓扑声明统一交给 Spring AMQP。完成本课配置后,应用启动时会建立可复用连接,并自动声明交换机、队列和绑定,业务代码可直接注入 RabbitTemplate 发送消息。

学习目标

  • 配置 Spring Boot 连接 RabbitMQ 所需的基础参数
  • 声明 RabbitTemplate、交换机、队列和绑定关系
  • 通过 RabbitMQ 管理命令验证 Spring AMQP 配置是否真正生效

引入 Spring AMQP 并配置连接

Spring Boot 项目只需引入 AMQP Starter,具体依赖版本交给当前 Spring Boot 依赖管理统一控制,不要单独给 RabbitMQ 客户端强行指定不匹配版本。

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

依赖生效后,Spring Boot 会根据 spring.rabbitmq 配置创建连接工厂。下面使用环境变量覆盖生产凭据,本地未提供时回退到 RabbitMQ 默认开发配置。

yaml
spring:
  rabbitmq:
    host: ${RABBITMQ_HOST:localhost}
    port: ${RABBITMQ_PORT:5672}
    username: ${RABBITMQ_USER:guest}
    password: ${RABBITMQ_PASSWORD:guest}
    virtual-host: ${RABBITMQ_VHOST:/}
    publisher-confirm-type: correlated
    publisher-returns: true
    template:
      mandatory: true

这里的 publisher-confirm-type 用于确认消息是否到达 Broker,publisher-returns 与 mandatory 用于处理无法路由到队列的消息。它们不是建立连接的必要条件,但能让后续发送链路具备明确的失败反馈。

声明交换机、队列、绑定与 RabbitTemplate

下面配置一个持久化直连交换机、持久化队列和确定的 routing key。Spring Boot 默认会提供可用的连接工厂;配置类只负责拓扑和 RabbitTemplate 的行为。

java
package com.example.rabbitmq;

import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.DirectExchange;
import org.springframework.amqp.core.ExchangeBuilder;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.core.QueueBuilder;
import org.springframework.amqp.rabbit.connection.ConnectionFactory;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class RabbitMqConfig {
    public static final String EXCHANGE = "demo.orders";
    public static final String QUEUE = "demo.orders.created";
    public static final String ROUTING_KEY = "orders.created";

    @Bean
    DirectExchange orderExchange() {
        return ExchangeBuilder.directExchange(EXCHANGE)
                .durable(true)
                .build();
    }

    @Bean
    Queue orderQueue() {
        return QueueBuilder.durable(QUEUE).build();
    }

    @Bean
    Binding orderBinding(Queue orderQueue, DirectExchange orderExchange) {
        return BindingBuilder.bind(orderQueue)
                .to(orderExchange)
                .with(ROUTING_KEY);
    }

    @Bean
    RabbitTemplate rabbitTemplate(ConnectionFactory connectionFactory) {
        RabbitTemplate template = new RabbitTemplate(connectionFactory);
        // mandatory=true 时,无法路由的消息可以进入 returned-message 回调链路。
        template.setMandatory(true);
        return template;
    }
}

配置生效后,Spring 容器中的 Queue、Exchange 和 Binding Bean 会由 AMQP 管理组件在连接可用时声明到 Broker。RabbitTemplate 本身可以作为单例注入业务服务,它会通过 Spring 管理的连接工厂获取和复用信道,而不是要求业务代码手工长期持有一个 Channel。

Spring AMQP 连接、模板与拓扑关系

验证拓扑是否已经声明

启动 Spring Boot 应用后,可以直接查询 RabbitMQ 节点。以下命令只验证本课声明的交换机、队列和绑定,不依赖管理后台界面。

bash
rabbitmqctl list_exchanges name type durable
rabbitmqctl list_queues name durable
rabbitmqctl list_bindings source_name destination_name routing_key

预期结果

text
name	type	durable
demo.orders	direct	true

name	durable
demo.orders.created	true

source_name	destination_name	routing_key
demo.orders	demo.orders.created	orders.created

实际命令会同时显示 Broker 上已有的其他对象,因此不要求整段输出完全一致;只要能分别找到这三个声明关系,就说明 Spring AMQP 拓扑初始化已经生效。

配置边界与常见失败

如果应用能启动但没有看到队列,先确认连接参数和 virtual host 是否正确,再检查当前账号是否拥有 configure、write、read 权限。交换机或队列已存在但属性与代码不一致时,RabbitMQ 会拒绝重新声明,此时应统一双方属性,而不是继续重试。

RabbitTemplate 适合由 Spring 单例管理,不要在每次发送消息时重新创建。连接与信道复用由 Spring AMQP 的连接工厂负责,业务代码只需要关注交换机、routing key、消息内容以及确认或退回策略,这样才能同时得到连接复用和线程安全的边界。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Spring AMQP 基础配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通