Spring Boot 3.1.4迁移报错：无法解析QueueMessagingTemplate符号

核心原因 #

你使用的spring-cloud-aws-dependencies:2.2.6.RELEASE是为Spring Boot 2.x版本设计的，与Spring Boot 3.1.4存在严重版本兼容性问题：

• 该版本依赖的Spring框架版本与Spring Boot 3.1.4不匹配，导致类加载时无法正确解析相关类
• Spring Cloud AWS从3.0版本开始调整了groupId（从org.springframework.cloud改为io.awspring.cloud），旧版依赖无法在Spring Boot 3.x环境中正常工作

解决方案 #

1. 升级Spring Cloud AWS依赖版本 #

将Gradle中的依赖配置替换为适配Spring Boot 3.1.4的版本：

// 替换原有的platform依赖
implementation(platform("io.awspring.cloud:spring-cloud-aws-dependencies:3.1.4"))

// 若使用SQS相关功能，添加对应starter依赖
implementation("io.awspring.cloud:spring-cloud-aws-starter-sqs")

注：3.1.4是与Spring Boot 3.1.4完全匹配的版本，也可选择同系列其他稳定版本

2. 清理并同步依赖 #

执行以下Gradle命令彻底清理缓存并重新拉取依赖：

./gradlew clean build --refresh-dependencies

3. 验证导入语句 #

确认代码中的导入语句无需修改，QueueMessagingTemplate在新版中仍位于原包路径：

import org.springframework.cloud.aws.messaging.core.QueueMessagingTemplate;

额外检查 #

• 查看IDE依赖管理面板，确保org.springframework.cloud:spring-cloud-aws-dependencies:2.2.6.RELEASE已被完全移除
• 若问题仍存在，通过./gradlew dependencies命令分析依赖树，排查是否有其他依赖引入了旧版Spring Cloud AWS的Jar包

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