如何在Django中直接将文件上传至S3（不使用django-storages）

你可以利用boto3的upload_fileobj方法直接上传Django的UploadedFile对象到S3，完全不需要本地存储文件。这个方法支持读取文件流，适配Django上传的文件对象。

完整代码示例 #

import boto3
import os
from django import forms

class UploadFileForm(forms.Form):
    file = forms.FileField()

# 视图函数内的处理逻辑
if request.method == 'POST':
    form = UploadFileForm(request.POST, request.FILES)
    if form.is_valid():
        uploaded_file = request.FILES['file']
        # 初始化S3客户端（推荐用环境变量配置凭证，避免硬编码）
        s3 = boto3.client(
            's3',
            aws_access_key_id=os.getenv('AWS_ACCESS_KEY_ID'),
            aws_secret_access_key=os.getenv('AWS_SECRET_ACCESS_KEY'),
            region_name=os.getenv('AWS_REGION')
        )
        
        bucket_name = 'your-target-bucket'  # 替换为你的目标S3桶名
        # 自定义S3中的文件路径/名称，加前缀避免重名
        s3_file_key = f"user-uploads/{uploaded_file.name}"

        try:
            # 直接上传文件流到S3
            s3.upload_fileobj(
                uploaded_file,
                bucket_name,
                s3_file_key,
                ExtraArgs={
                    'ContentType': uploaded_file.content_type,  # 保留原文件MIME类型
                    'ACL': 'private'  # 根据需求设置权限，如public-read
                }
            )
            print("文件已成功上传至S3")
        except Exception as e:
            # 处理上传失败的情况
            print(f"S3上传失败: {str(e)}")

关键说明 #

• upload_fileobj方法：核心方法，接受任何实现了read()的文件类对象（Django的UploadedFile符合要求），直接读取上传流发送到S3，跳过本地存储。
• 凭证配置：不要硬编码AWS密钥，优先用环境变量、AWS配置文件（~/.aws/credentials）或IAM角色（部署在AWS服务上时）配置，保证安全。
• ExtraArgs参数：
  • ContentType：必须设置，否则S3会默认标记文件为binary/octet-stream，导致浏览器无法正确预览图片、文档等。
  • ACL：根据业务需求设置权限，比如private仅桶所有者可访问，public-read允许公开访问。
• 文件命名：自定义s3_file_key时可添加前缀（如用户ID、日期目录），避免文件名冲突，比如f"uploads/2024/05/{uploaded_file.name}"。

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