如何配置AWS S3存储桶以阻止插入同名已存在的文件？

方法1：通过请求条件头（适合可控的上传场景） #

在发起PutObject请求时，添加If-None-Match: * HTTP请求头（对应AWS SDK的参数例如Python SDK中的ExtraArgs={'IfNoneMatch': '*'}）。

当桶中已存在同名对象时，S3会返回412 Precondition Failed错误，直接拒绝上传；仅当对象不存在时，上传操作才会完成。

示例（AWS CLI）：

aws s3 cp local-file.txt s3://your-bucket/target-path.txt --no-clobber

--no-clobber参数本质就是自动添加了If-None-Match: *头，实现同名文件的覆盖阻止。

方法2：通过Bucket Policy强制全局阻止（适合所有上传场景） #

如果需要强制所有上传请求遵守“不覆盖同名文件”规则，无需依赖上传者手动配置请求头，可以通过Bucket Policy拒绝所有未携带If-None-Match: *头的PutObject操作：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Principal": "*",
            "Action": "s3:PutObject",
            "Resource": "arn:aws:s3:::your-bucket-name/*",
            "Condition": {
                "StringNotEquals": {
                    "s3:RequestHeader/x-amz-if-none-match": "*"
                }
            }
        }
    ]
}

该策略会直接拦截未满足条件的上传请求，确保只有当目标对象不存在时，上传才能成功。

关键注意点 #

• 若存储桶开启了版本控制，默认PutObject会生成新版本而非覆盖旧对象。结合上述方法后，S3会检查是否存在任何版本的同名对象，若存在则拒绝上传，不会生成新版本。
• Object Lock仅用于保护现有对象不被删除或修改（通过保留策略/合法保留），确实无法阻止同名对象的新版本创建，因此不适用你的需求。

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