Spring Boot集成RabbitMQ无法自动装配ConnectionFactory、RabbitTemplate

你提供的pom.xml已经正确引入了spring-boot-starter-amqp依赖，按照Spring Boot的自动装配规则，确实会默认创建ConnectionFactory和RabbitTemplate类型的Bean，出现找不到Bean的报错基本是以下几种情况：

• IDE静态检查误报：这是出现概率最高的情况，IDEA的Spring静态扫描机制对部分自动装配的Bean存在识别漏判，尤其是Spring Boot 2.7.x版本搭配非对应版本的IDEA时，经常出现编辑器标红但代码实际运行正常的情况。
• 包扫描范围配置错误：Spring Boot启动类放置的路径不合理，没有放在项目代码的根包层级，导致默认的组件扫描范围没有覆盖到RabbitMQ相关的自动配置类，相关Bean没有被创建。
• 自动配置被主动排除：代码或配置文件中手动排除了RabbitMQ对应的自动配置类，导致自动装配逻辑不生效。
• 本地依赖损坏：Maven本地仓库中spring-boot-starter-amqp相关的jar包下载不完整，导致自动配置类无法被正常加载。

按优先级从高到低依次排查：

1. 先确认是否为IDE误报
   直接运行项目的启动类，如果启动过程没有抛出NoSuchBeanDefinitionException类型的异常，代码中注入的RabbitTemplate可以正常调用，就只是编辑器的误报。可以通过以下方式解决：
   • 执行mvn clean compile命令重新编译项目，在IDEA的Maven面板点击刷新按钮重新加载所有依赖
   • 如果还是标红，在注入对应Bean的字段上添加@SuppressWarnings("SpringJavaInjectionPointsAutowiringInspection")注解即可消除警告，不会影响代码实际运行逻辑。
2. 修正启动类包路径
   将Spring Boot启动类移动到项目的根包下（对应你的项目就是com.example包路径），保证@SpringBootApplication注解的默认扫描范围可以覆盖所有项目代码，不需要额外添加@ComponentScan注解指定扫描路径。
3. 检查自动配置排除项
   • 查看启动类上的@SpringBootApplication注解，如果存在exclude = {RabbitAutoConfiguration.class}这类配置，直接删除该排除项
   • 查看application.yml或application.properties配置文件，如果存在spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.amqp.RabbitAutoConfiguration配置，直接删除该行
4. 修复损坏的本地依赖
   在项目根目录执行mvn dependency:resolve命令，查看控制台输出是否有依赖下载失败的提示，如果存在下载失败的依赖，去本地Maven仓库路径下删除对应损坏的文件夹，重新执行依赖下载即可。

如果以上步骤都完成后启动仍然报错，可以在配置文件中添加RabbitMQ的基础连接配置，触发自动装配逻辑加载：

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

配置完成后重启项目即可正常注入相关Bean。

内容的提问来源于stack exchange，提问作者Braintertainer