使用Flask上传图片至S3子文件夹时URL对应文件0字节损坏如何解决

上传后S3内文件为0KB、打开损坏，和你用子文件夹没有直接关系——S3本身没有文件目录结构，所谓子文件夹只是对象Key的前缀字符串，不会导致内容损坏。
核心问题是你传给put_object的Body是Flask返回的FileStorage类文件流对象，boto3上传类文件流时，会从流的当前指针位置开始读取内容：只要在调用上传逻辑前，对这个文件对象做过任何读取操作（包括校验文件头、判断文件类型、临时落盘、打印内容等），流指针就会停在内容末尾，此时boto3读不到任何有效内容，上传的自然是0字节空文件。
你之前传根目录正常，只是那次测试场景下没有提前读取流，指针刚好在起始位置而已，和路径无关。

• 上传前强制重置流指针
  不管之前有没有做过文件读取操作，在传给S3上传方法前，先把流指针拨到起始位置，彻底避免空读问题。修改你的文件循环逻辑：

  from werkzeug.utils import secure_filename 
  url_attach = []
  image_file = request.files.getlist('files')
  for item in image_file:
      filename = secure_filename(item.filename)
      item.seek(0)  # 强制把指针移到文件开头
      url = upload2s3(item, filename)
      url_attach.append(url)
  

  如果想彻底规避流对象的指针问题，可以直接读取文件的二进制字节内容上传，修改upload2s3内的上传逻辑：

  def upload2s3(img_content, key_name):
      try:
          file_name = f"{AWS_BUCKET_SUBFOLDER}/{key_name}"
          s3_conn = boto3.client(
              "s3",
              aws_access_key_id=AWS_ACCESS_KEY_ID,
              aws_secret_access_key=AWS_SECRET_KEY,
          )
          img_content.seek(0)
          file_bytes = img_content.read() # 直接读为二进制字节，不存在指针偏移问题
          resp = s3_conn.put_object(Bucket=BUCKET_NAME, Body=file_bytes, Key=file_name)
          # 增加上传结果校验，避免静默失败
          if resp['ResponseMetadata']['HTTPStatusCode'] != 200:
              return {"status": False, "message": "S3上传返回状态异常"}
          url = create_url(BUCKET_NAME, file_name )
          return url
      except Exception as ex:
          return {"status": False, "message": str(ex)}
  

• 清理冗余逻辑问题
  • 不要每次上传、生成URL都新建boto3客户端，把客户端初始化抽到函数外全局复用，减少重复鉴权开销
  • 不要在S3控制台手动创建对应前缀的"空文件夹"：手动创建文件夹会生成一个0字节的占位对象（Key为子文件夹名/），虽然不影响正常文件上传，但属于冗余内容
  • 异常捕获时要把异常对象转成字符串，避免返回无法序列化的异常实例

上传完成后先调用head_object接口核对文件大小，和本地文件大小一致后再生成预签名URL：

file_meta = s3_conn.head_object(Bucket=BUCKET_NAME, Key=file_name)
print(file_meta['ContentLength']) # 该值和本地文件字节数一致才说明上传正常

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