升级至Java 17 & Spring 3.1.0后SQS Listener失效求助

依赖版本校验 #

• 确认Spring Cloud AWS依赖版本与Spring 3.1.0匹配：Spring 3.x对应Spring Cloud 2022.0.x（Kilburn）版本，确保spring-cloud-starter-aws-messaging版本正确，避免版本冲突。示例Maven依赖：

  <dependency>
      <groupId>org.springframework.cloud</groupId>
      <artifactId>spring-cloud-starter-aws-messaging</artifactId>
      <version>3.1.0</version>
  </dependency>
  

• 排查AWS SDK版本冲突：Spring Cloud 3.x默认使用AWS SDK v2，若手动引入了旧版aws-java-sdk-sqs（SDK v1），需替换为SDK v2的software.amazon.awssdk:sqs依赖。

配置类与Bean验证 #

• 检查手动创建的SQS客户端Bean类型：Spring Cloud 3.x的SQS Listener依赖SqsAsyncClient（SDK v2），而非旧版AmazonSQS。若仍使用SDK v1，需确保创建AmazonSQSAsync Bean而非AmazonSQS。
• 确认启用SQS Listener扫描：在配置类上添加@EnableSqs注解，该注解是触发Listener注册的核心配置。
• 验证配置类的可扫描性：确保配置类带有@Configuration注解，且所在包在Spring组件扫描路径范围内。

Listener注解与组件扫描检查 #

• 确认Listener类被Spring管理：Listener类需添加@Component或@Service注解，且所在包在@SpringBootApplication的扫描路径下。
• 校验@SqsListener注解参数：队列名称需正确（可使用配置文件变量），若使用队列ARN需确保格式无误。示例：

  @SqsListener("${aws.sqs.target-queue}")
  public void processMessage(String messageBody) {
      // 消息处理逻辑
  }
  

• 确认注解包路径正确：Spring Cloud AWS 3.x中@SqsListener的包为org.springframework.cloud.aws.messaging.listener.annotation.SqsListener，避免使用旧版包路径。

日志调试与问题定位 #

• 调整日志级别至DEBUG：开启org.springframework.cloud.aws、software.amazon.awssdk.sqs（SDK v2）或com.amazonaws.services.sqs（SDK v1）包的DEBUG日志，查看：
  • 启动时是否有Listener注册日志（如Registering message listener for queue [xxx]）
  • 是否有SQS请求/响应日志，确认是否发起了ReceiveMessage请求
  • 是否有未捕获的异常被日志框架吞掉
• 检查Listener线程池状态：确认SQS Listener的线程池是否正常初始化，是否存在线程阻塞或资源耗尽情况。

权限与队列配置验证 #

• 确认AWS凭证权限：服务使用的IAM角色/用户需具备SQS的ReceiveMessage、DeleteMessage权限（仅SendMessage权限不足以接收消息）。
• 检查队列属性：验证队列的可见性超时、消息保留期是否配置合理，FIFO队列需确保发送消息时携带正确的messageGroupId，且Listener处理逻辑兼容FIFO特性。
• 确认队列状态：检查队列是否有未被消费的消息，是否被其他消费者占用。

Spring自动装配差异排查 #

• 检查自动装配排除项：查看配置文件中spring.autoconfigure.exclude是否排除了SQS相关自动配置类（如SqsAutoConfiguration）。
• 对比Spring 2.5.x与3.x的自动装配逻辑：Spring 3.x移除了部分旧版自动装配规则，需确保Listener依赖的辅助Bean（如SqsMessageListenerContainer）已被正确初始化。

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