DigitalOcean上S3Client连接池超时：无法执行HTTP请求

你的问题本质是AWS Java SDK v1的AmazonS3客户端默认HTTP连接池未启用空闲连接回收机制，导致连接被永久占用，累计到配置的最大连接数后触发超时。哪怕生成预签名URL不需要实际发起HTTP请求，客户端内部的HTTP实例仍会占用连接池资源，最终耗尽所有可用连接。

方案1：配置连接池自动回收空闲连接 #

修改getS3Client()方法，添加连接池超时配置，让闲置连接自动被回收：

AmazonS3 getS3Client() {
    if (s3Client == null) {
        ClientConfiguration clientConfig = new ClientConfiguration()
                .withMaxConnections(20) // 根据实际并发调整
                .withConnectionIdleTimeout(10000) // 10秒空闲后回收连接
                .withConnectionTimeout(5000) // 连接超时时间
                .withSocketTimeout(5000); // Socket超时时间

        AWSStaticCredentialsProvider credentials =
                new AWSStaticCredentialsProvider(new BasicAWSCredentials(accessKey, secret));
        s3Client = AmazonS3ClientBuilder
                .standard()
                .withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration(endpoint, region))
                .withCredentials(credentials)
                .withClientConfiguration(clientConfig)
                .build();
    }
    return s3Client;
}

方案2：显式清理客户端连接池 #

如果配置超时后仍有问题，可以在应用关闭时统一关闭客户端，释放所有连接资源：

// 注册应用关闭钩子，退出时清理客户端
Runtime.getRuntime().addShutdownHook(new Thread(() -> {
    if (s3Client != null) {
        s3Client.shutdown();
    }
}));

方案3：升级到AWS SDK v2（推荐） #

AWS SDK v2重写了底层HTTP实现，连接池管理更高效，默认自动回收空闲连接，性能也更优。适配DigitalOcean Spaces的代码示例：

// 初始化单例S3客户端
S3Client s3Client = S3Client.builder()
        .endpointOverride(URI.create(endpoint))
        .credentialsProvider(StaticCredentialsProvider.create(AwsBasicCredentials.create(accessKey, secret)))
        .region(Region.of(region))
        .serviceConfiguration(config -> config.pathStyleAccessEnabled(true)) // DO Spaces必须开启路径风格访问
        .build();

// 生成预签名URL方法
String getSignUrl(String objectKey, Long expirationMillis) {
    try {
        GetObjectRequest getObjectRequest = GetObjectRequest.builder()
                .bucket(spaceName)
                .key(objectKey)
                .build();

        Duration expiration = Duration.ofMillis(expirationMillis);
        PresignedGetObjectRequest presignedRequest = s3Client.presignedGetObject(getObjectRequest, expiration);
        return presignedRequest.url().toString();
    } catch (S3Exception e) {
        log.error(e.getMessage(), e);
    }
    return null;
}

// 应用关闭时关闭客户端
s3Client.close();

注意事项 #

• DigitalOcean Spaces兼容S3 API，但SDK v2必须开启路径风格访问，否则会出现请求错误。
• withConnectionIdleTimeout是解决连接池耗尽的核心配置，它会让连接池定期清理闲置连接，避免资源被永久占用。

内容的提问来源于stack exchange，提问作者Alex A.