Spring AWS Cloud构建SQS消费者遇类路径多HTTP实现异常

问题根源 #

你碰到的问题是AWS SDK依赖重复引入导致类路径上存在多个HTTP客户端实现。虽然spring-cloud-aws-starter-sqs本身不包含HTTP客户端，但它会通过Spring Cloud AWS的BOM引入AWS SDK的特定模块；而你手动添加的software.amazon.awssdk:aws-sdk-java是全量SDK包，默认包含了ApacheSdkHttpService和UrlConnectionSdkHttpService两种HTTP实现，两者叠加触发了AWS SDK的冲突检测逻辑，导致上下文加载失败。

解决方案 #

方案1：移除全量AWS SDK依赖（推荐）

Spring Cloud AWS Starter已经通过依赖管理（BOM）维护了AWS SDK的版本和必要模块，不需要手动引入全量的aws-sdk-java。直接删除以下依赖行：

implementation 'software.amazon.awssdk:aws-sdk-java:2.21.0'

如果代码中需要Kinesis相关功能，保留software.amazon.kinesis:amazon-kinesis-client即可，它会自动依赖所需的AWS SDK子模块，不会引入冗余的HTTP客户端实现。

方案2：排除冗余的HTTP客户端实现

如果必须保留全量AWS SDK，可以在依赖声明中排除其中一个HTTP实现：

• 排除Apache HTTP客户端：

implementation 'software.amazon.awssdk:aws-sdk-java:2.21.0' {
    exclude group: 'software.amazon.awssdk', module: 'apache-client'
}

• 或者排除UrlConnection HTTP客户端：

implementation 'software.amazon.awssdk:aws-sdk-java:2.21.0' {
    exclude group: 'software.amazon.awssdk', module: 'url-connection-client'
}

方案3：显式指定默认HTTP客户端

通过系统属性强制指定使用某一种HTTP实现，比如在测试的JVM参数中添加：

-Dsoftware.amazon.awssdk.http.service.impl=software.amazon.awssdk.http.urlconnection.UrlConnectionSdkHttpService

或者在代码初始化SQS客户端时显式配置：

SqsClient sqsClient = SqsClient.builder()
        .httpClient(UrlConnectionHttpClient.create())
        .build();

验证 #

修改依赖或配置后，重新执行./gradlew test，contextLoad()测试应该能正常通过。

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