迁移至awspring cloud messaging 2.4.1时@EnableSqs弃用如何启用SQS

@EnableSqs在2.4.1版本被标记废弃的核心原因是：框架已经将SQS相关的Bean注册、监听器容器启动等逻辑全部整合到自动配置模块，不再需要手动通过注解触发装配。

Spring Boot 场景（绝大多数项目适用） #

• 移除所有配置类、启动类上标注的@EnableSqs注解，不需要替换为其他注解。
• 引入官方SQS starter依赖，替换原有单独引入的messaging包依赖：

<!-- Maven 依赖 -->
<dependency>
    <groupId>io.awspring.cloud</groupId>
    <artifactId>spring-cloud-aws-starter-sqs</artifactId>
    <version>2.4.1</version>
</dependency>

// Gradle 依赖
implementation 'io.awspring.cloud:spring-cloud-aws-starter-sqs:2.4.1'

• 在配置文件中按需配置SQS基础参数，云上环境如果已经通过实例角色、默认凭证链提供鉴权信息，甚至可以零配置启动：

spring:
  cloud:
    aws:
      region:
        static: ap-southeast-1 # 替换为你实际使用的AWS区域
      sqs:
        listener:
          max-concurrent-messages: 5 # 单监听器并发消费线程数
          default-deletion-policy: ON_SUCCESS # 消费成功后自动删除消息
        # 本地对接LocalStack等自定义场景才需要配置端点
        # endpoint: http://localhost:4566

• 业务层代码不需要改动，直接使用@SqsListener注解标注监听方法即可正常消费消息：

@Component
public class OrderMessageListener {
    @SqsListener("order-event-queue")
    public void processOrderEvent(String payload) {
        // 原有消息处理逻辑完全保留
    }
}

非Spring Boot 纯Spring场景 #

如果项目没有使用Spring Boot自动装配能力，直接导入框架提供的原生配置类即可，无需使用废弃的@EnableSqs：

@Configuration
@Import(io.awspring.cloud.messaging.config.SqsConfiguration.class)
public class CustomSqsConfig {
    // 手动注入AmazonSqs客户端、凭证提供器等必要Bean
}

注意：@EnableSqs在awspring 3.x版本已经被完全移除，迁移时不要为了临时兼容保留该注解，避免后续版本升级出现启动报错。如果配置后监听器不生效，优先检查是否引入了正确的starter依赖、队列名称是否配置正确、AWS鉴权与区域配置是否有效。

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