SpringBoot应用无法读取SQS消息，@SqsListener方法未触发求助

1. 启用SQS监听器支持 #

确保Spring Boot启动类上添加@EnableSqs注解，这是激活@SqsListener功能的核心配置：

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

2. 核对队列名称/ARN #

@SqsListener("sqs-queue")中的队列名称需与AWS控制台创建的队列完全一致，也可使用队列完整ARN。如果是自定义端点（如LocalStack），需确认名称匹配无误。

3. 验证AWS配置完整性 #

检查application.properties或application.yml中的AWS配置是否正确：

# 区域配置
cloud.aws.region.static=us-east-1
# 密钥配置（本地测试用，生产建议用IAM角色）
cloud.aws.credentials.access-key=你的AccessKey
cloud.aws.credentials.secret-key=你的SecretKey
# 自定义端点（如LocalStack）
cloud.aws.end-point.uri=http://localhost:4566

如果部署在AWS服务（EC2/EKS）上，需确保实例角色拥有sqs:ReceiveMessage、sqs:DeleteMessage等权限。

4. 检查依赖正确性 #

确保pom.xml中引入匹配Spring Boot版本的Spring Cloud AWS Messaging依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-aws-messaging</artifactId>
    <!-- Spring Boot 3.x对应Spring Cloud 2022.x版本，按需调整 -->
    <version>3.1.0</version>
</dependency>

5. 确认日志级别配置 #

检查日志配置是否开启INFO级别，保证logger.info(message)能输出到控制台：

logging:
  level:
    com.example.aws: INFO

6. 排查消息可见性问题 #

去AWS控制台查看队列的「Messages Available」数量，确认有待消费消息；同时检查消息可见性超时时间，避免消息被其他消费者长时间占用导致当前监听器无法读取。

7. 检查异步线程配置 #

Spring Cloud AWS默认用异步线程处理SQS消息，若自定义了TaskExecutor，需确保配置合理：

@Configuration
public class SqsConfig {
    @Bean
    public SimpleMessageListenerContainerFactory simpleMessageListenerContainerFactory(AmazonSQSAsync amazonSqs) {
        SimpleMessageListenerContainerFactory factory = new SimpleMessageListenerContainerFactory();
        factory.setAmazonSqs(amazonSqs);
        factory.setTaskExecutor(Executors.newFixedThreadPool(5));
        return factory;
    }
}

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