如何在Django中通过预签名Post URL上传文件到S3后更新FileField文件名？

当你已经通过预签名URL将大文件上传到AWS S3，需要关联到Django模型的FileField时，核心是让FileField指向S3中已存在的文件键（而非完整URL），以下是具体实现步骤：

1. 确认模型存储后端配置 #

确保你的模型FileField使用了django-storages的S3存储后端，示例配置：

from django.db import models
from storages.backends.s3boto3 import S3Boto3Storage

# 初始化S3存储后端（可根据需求添加bucket_name、region等配置）
s3_storage = S3Boto3Storage()

class YourModel(models.Model):
    large_file = models.FileField(storage=s3_storage, blank=True, null=True)
    # 其他业务字段...

2. 获取S3文件的键（Key） #

你需要获取已上传文件在S3中的对象键，这是文件在存储桶内的相对路径（例如uploads/2024/05/large_document.zip），而非完整的S3访问URL。

3. 关联文件到FileField #

方式一：通过Django File对象关联（推荐） #

这种方式符合Django文件处理规范，会自动触发模型的文件相关逻辑：

from django.core.files.base import File
from yourapp.models import YourModel

# 获取要更新的模型实例
instance = YourModel.objects.get(pk=1)
# 替换为你的S3文件键
s3_file_key = "uploads/2024/05/large_document.zip"
# 创建File对象关联已存在的S3文件（mode设为'r'即可，无需读写文件内容）
instance.large_file = File(None, name=s3_file_key)
# 保存实例更新数据库
instance.save()

方式二：直接更新数据库字段（高效但需谨慎） #

如果不需要触发Django的文件信号（如post_save），可以直接更新数据库字段：

from yourapp.models import YourModel

YourModel.objects.filter(pk=1).update(large_file="uploads/2024/05/large_document.zip")

关键注意事项 #

• 权限验证：确保Django使用的IAM用户拥有该S3文件的读取权限，否则后续访问FileField的url属性会报错。
• 存储后端的location参数：如果你的S3存储后端配置了location（指定存储到桶内的子目录），只需传入相对于location的路径即可，后端会自动拼接完整的S3键。
• 不要存储完整URL：FileField会自动根据存储后端生成访问URL，直接存储S3文件键才是正确的做法。

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