AWS S3调用createMultipartUpload时抛出NoSuchBucketException问题

核心问题：异步方法未等待执行结果 #

你的bucketExists方法存在逻辑错误：S3AsyncClient.headBucket返回的是异步任务CompletableFuture，你调用该方法后直接返回true，根本没有等待异步请求完成并验证实际结果。这意味着无论桶是否真的存在，这个方法都会直接返回true，导致你误以为桶已存在，但实际可能并非如此。

修复bucketExists方法 #

需要等待异步请求完成后再判断结果，同时将方法改为suspend以支持协程异步等待：

private suspend fun bucketExists(s3Client: S3AsyncClient, bucketName: String): Boolean {
    return runCatching {
        s3Client.headBucket(
            HeadBucketRequest.builder()
                .bucket(bucketName)
                .build()
        ).await() // 等待异步请求执行完成
        true
    }.getOrElse {
        false
    }
}

其他可能的原因排查 #

如果修复后仍报错，检查以下几点：

• 区域不匹配：确认S3AsyncClient配置的区域和桶实际所在区域完全一致。S3是区域级服务，客户端区域与桶区域不匹配时，会出现找不到桶的错误。
• 桶名一致性：S3桶名在大多数区域要求小写，若桶名包含大写字母，可能导致请求失败（除非是在支持大小写区分的旧区域）。确保代码中使用的桶名与实际桶名完全一致（包括大小写、特殊字符）。
• 权限不足：检查客户端使用的IAM权限是否允许执行CreateMultipartUpload操作。即使能执行HeadBucket，也可能缺少分片上传的权限。
• 一致性延迟：如果桶是刚创建的，S3可能存在短暂的最终一致性延迟，等待几分钟后再尝试。

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