如何解决AWS SDK运行时错误：类路径存在多个HTTP实现

你的问题根源是AWS SDK v2在classpath中检测到多个HTTP客户端实现（比如UrlConnection、Apache HttpClient等），无法自动选择默认实现——你之前手动实现SdkHttpClient的方式完全不对，SDK需要的是官方提供的已实现的HTTP客户端实例，不是空实现的匿名类。

以下是三种可行的解决方法，按推荐程度排序：

方法1：显式指定全局默认HTTP客户端（最简单） #

通过设置系统属性software.amazon.awssdk.http.service.impl，指定一个HTTP客户端的全限定类名（FQCN），让SDK全局使用该实现。

两种设置方式： #

• JVM启动参数：在程序启动时添加参数

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

  （如果想用Apache HttpClient，替换为software.amazon.awssdk.http.apache.ApacheSdkHttpService）

• 代码中设置：在程序最开始的初始化代码中添加（必须在创建任何AWS客户端之前执行）

  System.setProperty("software.amazon.awssdk.http.service.impl", 
                      "software.amazon.awssdk.http.urlconnection.UrlConnectionSdkHttpService");
  

方法2：给每个AWS客户端显式指定同一个HTTP客户端实例 #

创建一个官方实现的HTTP客户端，然后在构建SsmClient和SnsClient时都指定这个实例，强制统一使用同一个HTTP实现。

示例代码： #

// 1. 创建共用的HTTP客户端（这里用UrlConnection实现，无需额外依赖）
SdkHttpClient sharedHttpClient = UrlConnectionHttpClient.create();

// 2. 构建SsmClient时指定该客户端
private static SsmClient ssmClient = SsmClient.builder()
        .region(Region.of(region == null ? Regions.US_EAST_1.getName() : region))
        .httpClient(sharedHttpClient)
        .build();

// 3. 构建SnsClient时同样指定该客户端
static SnsClient snsClient = SnsClient.builder()
        .credentialsProvider(DefaultCredentialsProvider.builder().build())
        .region(region == null ? Region.US_EAST_1 : Region.of(region))
        .httpClient(sharedHttpClient)
        .build();

// 初始化SSMProvider
private static SSMProvider ssmProvider = ParamManager.getSsmProvider(ssmClient);

如果想用Apache HttpClient，需要先在build.gradle中添加依赖：

implementation 'software.amazon.awssdk:apache-client:2.15.0'

然后替换创建客户端的代码：

SdkHttpClient sharedHttpClient = ApacheHttpClient.create();

方法3：通过Gradle排除多余的HTTP客户端依赖 #

如果两个依赖分别引入了不同的HTTP客户端实现，可以排除其中一个的依赖，只保留一种实现。

示例（假设powertools-parameters引入了Apache HttpClient，而你想保留UrlConnection）： #

implementation ('software.amazon.lambda:powertools-parameters:1.12.3') {
    // 排除Apache HttpClient依赖
    exclude group: 'software.amazon.awssdk', module: 'apache-client'
}

或者反过来，如果sns引入了UrlConnection，排除它：

implementation ('software.amazon.awssdk:sns:2.15.0') {
    exclude group: 'software.amazon.awssdk', module: 'url-connection-client'
}

注意： #

执行排除操作前，可以用gradle dependencies命令查看依赖树，确认哪个依赖引入了多余的HTTP客户端实现，避免误排除。

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