Spring Boot升级后SQSAutoConfiguration自动配置类缺失原因排查咨询

以下是排查Spring不再加载SQSAutoConfiguration类的实用工具和技术：

• Spring Boot自动配置报告
  启动应用时添加--debug参数，控制台会输出所有自动配置类的加载详情，包括启用状态、排除原因（如依赖缺失、条件不满足等）。也可通过spring-boot:run -Ddebug命令启动，或在配置文件中设置debug=true。

• @Conditional条件验证
  查看SQSAutoConfiguration类上的所有@Conditional注解（如@ConditionalOnClass、@ConditionalOnProperty等），逐一验证：

  • 用gradle dependencies检查是否缺失条件依赖的类；
  • 核对配置文件中相关属性是否符合要求；
  • 确认Spring上下文是否存在条件所需的Bean。

• Trace级日志追踪
  将org.springframework.boot.autoconfigure、io.awspring.cloud.autoconfigure包的日志级别调整为TRACE，查看自动配置类的扫描、筛选全过程，定位被跳过的具体环节。

• 扫描范围与排除规则检查

  • 确认@SpringBootApplication的扫描范围是否覆盖io.awspring.cloud.autoconfigure包，若自定义了scanBasePackages需确保包含该路径；
  • 检查代码中是否存在@ComponentScan排除规则，或@EnableAutoConfiguration(exclude = ...)主动排除了该类。

• 兼容性校验
  验证io.awspring.cloud:spring-cloud-aws-autoconfigure:2.4.4与Spring Boot 3.1.2的兼容性：Spring Boot 3.x基于Jakarta EE，旧版本spring-cloud-aws可能仍依赖Java EE API，存在兼容性问题导致自动配置类无法加载。

• Bean定义注册表调试
  自定义BeanFactoryPostProcessor，在Bean定义注册阶段打印所有已注册的自动配置类Bean定义，对比升级前后的差异，确认SQSAutoConfiguration是否被注册。

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