如何用AWS Java SDK 2.x获取S3对象URL及迁移适配问题

你已经梳理了大部分1.x到2.x的操作映射，以下是剩余两个方法的替代实现方案：

操作映射补充 #

详细实现说明 #

1. getUrl(String bucket, String key) 替代方案 #

SDK 2.x没有直接提供getUrl的异步方法，你可以通过两种方式实现：

方式一：使用同步客户端的工具类构造URL

// 初始化同步S3客户端（仅用于生成URL，无需额外异步处理）
S3Client s3Client = S3Client.create();

GetUrlRequest getUrlRequest = GetUrlRequest.builder()
    .bucket(bucketName)
    .key(objectKey)
    .build();

// 获取对象的URI
URI objectUri = s3Client.utilities().getUrl(getUrlRequest);

方式二：手动构造URL

根据S3的URL规则直接拼接（需注意区域、存储桶命名风格等细节）：

// 示例：虚拟托管风格URL（适用于大多数场景）
String objectUrl = String.format("https://%s.s3.%s.amazonaws.com/%s", 
    bucketName, 
    s3Client.serviceConfiguration().region().id(), 
    objectKey);

2. doesObjectExist(String bucket, String key) 替代方案 #

SDK 2.x移除了直接的存在性检查方法，需通过headObject请求判断：

// 异步客户端实现
CompletableFuture<Boolean> objectExistsFuture = s3AsyncClient.headObject(
        HeadObjectRequest.builder()
            .bucket(bucketName)
            .key(objectKey)
            .build())
    .thenApply(response -> true)
    .exceptionally(throwable -> {
        if (throwable instanceof S3Exception s3Ex) {
            return s3Ex.statusCode() == 404;
        }
        // 其他异常根据业务需求处理，示例直接抛出
        throw new RuntimeException(throwable);
    });

// 如需同步获取结果
Boolean exists = objectExistsFuture.join();

注意：使用headObject只会获取对象的元数据，不会下载完整对象，性能与原doesObjectExist相当。

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