Swift中判断AWS S3对象是否存在，避免重复上传

核心思路 #

别用listObjectsV2()做批量查询，这个接口是用来列举桶内对象的，数据量大时会分页返回，效率极低。正确的做法是用**headObject接口**——它直接针对单个对象查询元数据，对象存在返回HTTP 200，不存在返回HTTP 404，单次请求就能得到结果，完全不受桶内数据量影响。

实现isAlreadyExist函数 #

以下是不同语言的示例实现：

Swift 示例 #

import AWSS3

func isAlreadyExist(key: String, bucketName: String) async throws -> Bool {
    let headObjectRequest = AWSS3HeadObjectRequest()
    headObjectRequest.bucket = bucketName
    headObjectRequest.key = key
    
    do {
        _ = try await AWSS3.default().headObject(headObjectRequest)
        return true
    } catch let error as NSError {
        // 捕获404错误，说明对象不存在
        if error.code == AWSS3Error.noSuchKey.rawValue {
            return false
        }
        // 其他错误抛出
        throw error
    }
}

注：这里的key就是你说的"路径"，S3里没有真正的文件夹，对象的key就是完整的路径格式（比如docs/report.pdf）。

Python 示例 #

import boto3
from botocore.exceptions import ClientError

def is_already_exist(key: str, bucket_name: str) -> bool:
    s3 = boto3.client('s3')
    try:
        s3.head_object(Bucket=bucket_name, Key=key)
        return True
    except ClientError as e:
        if e.response['Error']['Code'] == '404':
            return False
        # 其他错误抛出
        raise e

Java 示例 #

import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.services.s3.model.HeadObjectRequest;
import software.amazon.awssdk.services.s3.model.NoSuchKeyException;

public boolean isAlreadyExist(String key, String bucketName) {
    try (S3Client s3 = S3Client.create()) {
        HeadObjectRequest request = HeadObjectRequest.builder()
                .bucket(bucketName)
                .key(key)
                .build();
        s3.headObject(request);
        return true;
    } catch (NoSuchKeyException e) {
        return false;
    }
}

优化方案：上传时直接避免覆盖 #

如果你的需求是"禁止重复上传"，可以不用先调用判断函数，直接在上传时添加条件参数，让S3自动校验：

• 使用PutObject接口时，添加If-None-Match: *请求头：如果对象已存在，S3会返回HTTP 412（前置条件失败），不会覆盖现有对象；如果不存在则正常上传。
• 或者使用PutObjectRequest的setIfNoneMatch("*")（Java）、ExtraArgs={'IfNoneMatch': '*'}（Python）等方式设置。

这种方式减少了一次API调用，更高效，也避免了"查询后上传"过程中对象被其他操作创建的竞态问题。

注意事项 #

• 确保你的IAM角色/用户拥有s3:GetObject权限（调用headObject需要这个权限）。
• S3的key是区分大小写的，比如Docs/Report.pdf和docs/report.pdf会被视为不同对象，判断时要注意一致性。

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