如何检查S3存储桶中是否存在指定文件？解决文件名重复问题

嘿，这问题挺常见的，我来帮你捋清楚怎么实现！核心思路就是循环生成随机文件名，每次生成后检查S3里有没有这个文件，直到找到一个不存在的为止。下面结合你的代码一步步来：

1. 实现文件存在性检查函数 #

用boto3的资源（Resource）或者客户端（Client）都能做，这里先贴合你用的资源写法：

首先要导入botocore.exceptions.ClientError来捕获文件不存在的异常：

from botocore.exceptions import ClientError

然后写检查函数：

def is_s3_file_exists(bucket, file_key):
    try:
        # 发送HEAD请求检查对象是否存在，只获取元数据，效率很高
        bucket.Object(file_key).load()
        return True
    except ClientError as e:
        # 错误码404表示文件不存在
        if e.response['Error']['Code'] == '404':
            return False
        # 其他错误（比如权限不足）直接抛出，需要你额外处理
        raise

2. 循环生成唯一文件名并上传 #

把你的代码修改成循环逻辑，确保拿到的文件名是唯一的：

img = request.FILES.get('image')
session = boto3.Session(
    aws_access_key_id=AWS_ACCESS_KEY_ID,
    aws_secret_access_key=AWS_SECRET_ACCESS_KEY,
)
s3 = session.resource('s3')
bucket = s3.Bucket('my-bucket')

# 循环生成随机文件名，直到找到不存在的
while True:
    filename = random_string()
    # 构造S3中的文件路径（根据你的需求调整前缀）
    file_key = f'media/{filename}'
    if not is_s3_file_exists(bucket, file_key):
        break

# 现在上传这个唯一的文件
bucket.put_object(Key=file_key, Body=img)

额外说明 #

• 为什么用load()而不是遍历存储桶？ 遍历整个存储桶（比如list_objects_v2）在文件多的时候会非常慢，而load()发送的是HEAD请求，只检查单个对象的存在性，效率高得多。
• 异常处理要注意：除了404错误，可能还会遇到403（权限不够）、500（服务端错误）等，这些异常需要你根据业务场景额外处理，不要直接忽略。
• 如果习惯用客户端（Client）写法，也可以用s3_client.head_object()来检查，逻辑是一样的：

  def is_s3_file_exists(s3_client, bucket_name, file_key):
      try:
          s3_client.head_object(Bucket=bucket_name, Key=file_key)
          return True
      except ClientError as e:
          if e.response['Error']['Code'] == '404':
              return False
          raise
  

这样就能确保你每次上传的文件名都是S3里没有的啦！

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