一、简述
Spring AMQP 是底层 RabbitMQ 客户端封装；spring-integration-amqp 是 Spring Integration 的适配器，它底层依赖 Spring AMQP，把 RabbitMQ 接入 Spring Integration 的消息通道（MessageChannel）、消息流转流水线。
关系：spring-integration-amqp → 依赖 → Spring AMQP（spring-rabbit）
1. Spring AMQP（spring-amqp / spring-rabbit）
定位：RabbitMQ 的 Spring 原生SDK，直接操作MQ 核心类：
RabbitTemplate：发消息、收消息、RPC@RabbitListener+ ListenerContainer：消费监听（最常用）RabbitAdmin：自动声明 exchange / queue / binding- ConnectionFactory、消息转换器、发布确认、返回回调、重试等
使用方式：直接在业务代码注入 RabbitTemplate，写 @RabbitListener，和普通业务代码耦合；适合大多数微服务、简单MQ场景。
// 典型 Spring AMQP 写法
rabbitTemplate.convertAndSend("exchange", "rk", payload);
@RabbitListener(queues = "queue1")
public void consume(String msg) {}模块组成：
spring-amqp：AMQP 抽象接口spring-rabbit：RabbitMQ 实现（真正干活的）
2. spring-integration-amqp
定位：Spring Integration 的 AMQP 通道适配器 ，不是独立MQ客户端，是消息中间件和 SI 消息总线之间的桥梁 Spring Integration 核心模型：Message → MessageChannel → Endpoint（转换器、过滤器、路由、聚合、分流等）
它提供这些端点：
AmqpInboundChannelAdapter：从RabbitMQ拉消息，转入SI通道AmqpOutboundChannelAdapter：从SI通道发消息到RabbitMQ（单向）AmqpInboundGateway / AmqpOutboundGateway：Request-Reply 模式（RPC）- 还支持基于AMQP的持久化 MessageChannel（队列作为channel）
特点：几乎不写 RabbitTemplate 调用代码，用配置（注解/XML）组装消息流 ，消息先进入SI的统一 org.springframework.messaging.Message，然后走SI的整套组件：filter、transformer、router、splitter、aggregator。
示例思路：
MQ消息 → AmqpInboundAdapter → MessageChannel → 转换器 → 路由 → AmqpOutboundAdapter → 另一个MQ3. 对比表
| 维度 | Spring AMQP（spring-rabbit） | spring-integration-amqp |
|---|---|---|
| 层级 | 底层MQ操作库 | 上层集成适配器 |
| 依赖 | 直接依赖 rabbitmq java client | 依赖 Spring AMQP |
| 消息模型 | AMQP Message | Spring Integration Message<T> |
| 开发模式 | 代码式：RabbitTemplate、@RabbitListener | 声明式、流水线、EIP企业集成模式 |
| 能力 | 连接、发送、消费、ACK、声明队列、重试、confirm | 在AMQP之上叠加EIP：过滤、路由、拆分、聚合、顺序流 |
| 适用场景 | 绝大多数业务：微服务异步、简单消费 | 复杂集成流：多源消息编排、ETL、多系统对接、协议转换 |
4. 选型建议
✅ 优先用 Spring AMQP（@RabbitListener + RabbitTemplate）
- 普通业务、微服务异步消息，简单生产消费，团队主流，调试简单、文档多、Spring Boot自动装配友好
✅ 选 spring-integration-amqp 的场景
- 你已经在用 Spring Integration，需要把 RabbitMQ 接入 SI 的消息流水线
- 需要大量 EIP 模式：消息路由、拆分聚合、消息过滤、跨多种中间件（MQ + HTTP + File + Kafka 一起编排） 缺点：学习曲线高，调试链路长，很多人不熟悉SI模型
❌ 误区：不是二选一；用 spring-integration-amqp 的项目，一定会引入 spring-amqp
5. 和 Spring Cloud Stream 的区别（顺带区分，容易混淆）
- Spring Cloud Stream：再上层，Binder抽象，不绑定RabbitMQ API，切换Kafka/Rabbit不用改业务
- Spring Integration：EIP编排框架，可以对接各种transport（amqp、kafka、http、file）
- Spring AMQP：裸RabbitMQ操作
二、两者区别
Spring AMQP（spring-rabbit）是操作 RabbitMQ 的基础客户端库；spring-integration-amqp 是 Spring Integration 的适配器，底层就是封装 Spring AMQP，目的是把 RabbitMQ 接入 Spring Integration 的 EIP 消息流水线。
依赖关系：
spring-integration-amqp→ 依赖spring-rabbit（Spring AMQP）
1. Spring AMQP（spring-rabbit）
定位：RabbitMQ 的 Spring 封装，面向业务直接收发消息 核心API：
RabbitTemplate：发送消息、RPC@RabbitListener：消费者（日常最常用）RabbitAdmin：自动创建交换机、队列、绑定- 连接工厂、消息转换器、confirm、return、重试、ack控制
开发方式：写业务代码直接调用、注解监听，消息就是 AMQP 的 Message。 适合场景：微服务异步通知、简单生产消费、大部分业务MQ场景。 优点：上手简单、调试直观、SpringBoot自动配置完善、社区最普及。 缺点：消息编排（过滤、拆分、聚合、路由、流转）需要自己手写代码实现。
示例逻辑： 业务代码 → RabbitTemplate / @RabbitListener → RabbitMQ
2. spring-integration-amqp
定位：集成桥梁，不是独立客户端，是 Spring Integration 和 RabbitMQ 之间的适配器 Spring Integration 是实现【EIP企业集成模式】的框架，有统一的 Message、MessageChannel、Endpoint（过滤器、转换器、路由器、拆分器、聚合器等）。 spring-integration-amqp 提供：
AmqpInboundChannelAdapter：从Rabbit收消息，转成SI Message送入通道AmqpOutboundChannelAdapter：从SI通道取出消息，发到RabbitAmqpInboundGateway / AmqpOutboundGateway：请求应答RPC模式
开发方式：声明式配置（注解/JavaDSL）搭消息流，很少直接写 RabbitTemplate。 消息路径： RabbitMQ → AmqpInboundAdapter → MessageChannel → Filter/Transformer/Router/Aggregator → AmqpOutboundAdapter → RabbitMQ（或其他端：HTTP、文件、Kafka等）
适合场景：多系统对接、复杂消息流转、多中间件混合编排、ETL、消息做一系列连续处理。 缺点：学习成本高、调用链路长，出问题排查更麻烦，国内用得相对少。
3. 清晰对比
| 对比项 | Spring AMQP（spring-rabbit） | spring-integration-amqp |
|---|---|---|
| 层级 | 底层MQ客户端 | 上层集成适配器 |
| 依赖 | 直接依赖Rabbit原生client | 强依赖 Spring AMQP |
| 消息模型 | AMQP Message | Spring Integration 统一 Message<T> |
| 编程风格 | 命令式：调用方法、注解监听 | 声明式流水线、EIP编排 |
| 核心能力 | 连接、发消息、消费、ack、队列声明、confirm | 在MQ之上，自带过滤、路由、拆分、聚合、分流等编排能力 |
| 耦合 | 业务代码和MQ直接打交道 | 业务解耦，业务不直接感知RabbitTemplate |
| 选型推荐 | ✅ 绝大多数项目首选 | ✅ 已有SI，或者需要复杂消息编排才选 |
4. 容易踩的误区
- 不是互斥！只要用 spring-integration-amqp，pom 里一定会带进 spring-rabbit
- Spring Cloud Stream 和 Spring Integration 又是另外一回事：
- Spring Cloud Stream：Binder抽象，切换Rabbit/Kafka几乎不改代码
- Spring Integration：EIP编排框架，可以对接多种中间件
- Spring AMQP：原生Rabbit操作
5. 快速选型口诀
- 只是发消息、消费MQ：Spring AMQP @RabbitListener
- 需要消息一路流转：收MQ → 转换 → 过滤 → 路由 → 再发MQ/调接口：Spring Integration + amqp适配器
三、适用场景
1、Spring AMQP（spring-rabbit）适用场景
本质：直接操作 RabbitMQ 的SDK，面向业务开发，命令式编程 ✅ 适合：
- 常规微服务异步通信 服务A发消息到Rabbit，服务B
@RabbitListener消费，做异步解耦、事件通知（订单创建、支付回调、库存扣减）。 - 简单的生产/消费、点对点、发布订阅 不需要复杂消息加工，拿到消息直接执行业务逻辑；发送就是
rabbitTemplate.convertAndSend。 - 需要精细控制 RabbitMQ 原生能力 手动ACK、消息确认confirm、return回调、死信队列、延迟消息、自定义交换机/队列、消息属性、优先级、批量发送。
- RabbitMQ RPC（Request/Reply）简单调用 直接用
RabbitTemplate的 sendAndReceive。 - 团队以业务开发为主，不想引入集成框架复杂度 上手快、问题栈清晰，出问题直接看listener、connection、channel，国内绝大多数Rabbit项目都是这个。
- 简单重试、本地事务、消息幂等（自己在listener内或者通过retryTemplate实现）
❌ 不太适合：
- 一条消息进来，要连续做：转换 → 过滤 → 分支路由 → 拆分多条 → 聚合结果 → 再转发到不同MQ/HTTP/文件
- 同时对接多种异构端点（Rabbit + Kafka + FTP + Http接口）统一编排
2、spring-integration-amqp 适用场景
本质：Spring Integration（EIP企业集成模式）的Rabbit适配器，消息流水线编排，底层依然调用Spring AMQP ✅ 适合：
- 复杂消息流转、多步骤处理管道 典型链路：
RabbitMQ收消息 → 格式转换(json→pojo) → 过滤无效消息 → 根据字段路由到不同分支 → 拆分消息 → 调用外部HTTP接口 → 聚合结果 → 发回另一个Rabbit队列这些Filter、Transformer、Router、Splitter、Aggregator都是SI原生组件，不用自己写大量胶水代码。 - 异构系统集成项目（ESB/轻量集成场景） 同一个应用内同时接入：RabbitMQ、Kafka、HTTP、文件、数据库、TCP，统一一套
MessageChannel模型流转消息。 比如：从Rabbit拿到上游系统报文，清洗转换后推送到第三方HTTP接口；或者文件落地后再投递MQ。 - 标准化EIP模式复用，集成流配置化 消息流用Java DSL /注解配置描述，而不是散落在各个Listener里；流的结构可视化、可复用。
- 以消息驱动为核心，业务逻辑和传输层彻底隔离 业务处理器不感知Rabbit，只接收SI的
Message<T>，切换传输载体（比如从Rabbit改成Kafka）只换适配器，中间处理链路不用改。 - 需要SI高级能力：消息持久通道、消息序列号、消息拦截器、消息重试流、错误通道（errorChannel）统一异常兜底 全局统一的异常流、死信转发、告警，而不是每个@RabbitListener单独写异常处理。
❌ 不太适合：
- 只是简单发消息、消费消息，没有中间编排步骤（太重，调试链路长、学习成本高）
- 团队不熟悉Spring Integration，出问题很难定位（栈会穿过SI通道、适配器、Rabbit三层）
- 追求极致简单、低延迟，不想多一层SI消息包装开销
三、场景对比速记表
| 场景 | 选 Spring AMQP | 选 spring-integration-amqp |
|---|---|---|
| 订单、支付、库存异步事件 | ✅ | ❌ |
| 简单消费，拿到消息直接执行业务 | ✅ | ❌ |
| 需要大量原生Rabbit特性精细控制 | ✅ | ❌（也能做，但麻烦） |
| 消息需要：过滤、转换、路由、拆分、聚合连续处理 | ❌ | ✅ |
| 同时对接MQ、HTTP、文件、数据库多源集成 | ❌ | ✅ |
| 统一全局消息异常流、错误通道、集成流配置化 | ❌ | ✅ |
| 轻量ESB、数据摆渡、报文ETL转换转发 | ❌ | ✅ |
四、补充一个边界判断小规则
你自问一句：
消息从Rabbit进来之后，是不是只做一件事就结束？
- 是 → Spring AMQP（
@RabbitListener） - 否，还要一串连续加工、分支转发、多端点流转 → Spring Integration + amqp适配器
额外提醒：spring-integration-amqp 不能脱离Spring Integration单独使用；而Spring AMQP是独立库。