Spring Boot中@SQSListener未触发求助：监听SQS无响应

1. 版本兼容性问题（核心） #

Spring Boot 3.1.0基于Spring 6/Jakarta EE，而你使用的spring-cloud-starter-aws-messaging:2.2.6.RELEASE是适配Spring Boot 2.x（Java EE）的版本，两者存在重大兼容性差异，会导致AWS消息监听的自动配置逻辑无法正常生效，进而@SqsListener注解不被识别。

解决方案：
替换为适配Spring Boot 3.x的AWS消息依赖。Spring Cloud AWS 3.x+版本已重构，使用新的依赖坐标：

// 替换原有的spring-cloud-starter-aws-messaging
implementation("io.awspring.cloud:spring-cloud-starter-aws-messaging:3.0.2")

注意：Spring Cloud AWS 3.x不再属于Spring Cloud官方子项目，groupId改为io.awspring.cloud。

2. 缺少AWS基础配置 #

若未正确配置AWS访问凭证和区域，应用无法连接到SQS服务，自然无法监听消息。需在application.properties或application.yml中添加以下配置：

# AWS区域（根据你的队列所在区域调整）
spring.cloud.aws.region.static=us-east-1
# AWS访问凭证（生产环境建议使用IAM角色而非硬编码）
spring.cloud.aws.credentials.access-key=your-access-key
spring.cloud.aws.credentials.secret-key=your-secret-key

如果在EC2/EKS等AWS托管环境运行，可省略凭证配置，应用会自动获取实例角色权限。

3. 队列权限或存在性问题 #

• 确认test-queue队列确实存在于你配置的AWS区域中
• 检查应用使用的AWS凭证是否拥有sqs:ReceiveMessage、sqs:DeleteMessage等必要权限（对应IAM策略）
• 确保队列名称拼写完全一致（SQS队列名称不区分大小写，但需避免拼写错误）

4. 未启用SQS监听自动配置（旧版本场景） #

在Spring Cloud AWS 2.x版本中，部分情况下需要在启动类上添加@EnableSqs注解来启用SQS监听功能：

@SpringBootApplication
@EnableSqs
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

不过如果是版本兼容性问题导致的异常，该注解无法解决根本问题，优先处理版本适配。

5. 消息转换异常（需排查日志） #

若发送到队列的消息格式与监听方法参数不匹配（比如JSON对象对应String参数），可能存在消息转换异常被框架吞掉的情况。建议添加日志框架（如logback），开启debug级别日志，查看是否有消息接收后的转换错误。

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