Django本地生成CSV保存至S3 Bucket时触发SuspiciousOperation异常

核心原因 #

Django的FileField默认依赖FileSystemStorage做路径安全校验，它仅允许访问MEDIA_ROOT目录下的文件。你直接传入/tmp/file.csv（不在MEDIA_ROOT范围内），就会触发SuspiciousOperation异常——这个问题和文件权限无关，是Django的安全机制限制。

解决方法 #

方法1：用File对象包装本地文件（推荐） #

不要直接给FileField.save()传本地文件路径，改用Django的django.core.files.File类包装文件对象，让Django直接读取文件内容，跳过路径校验：

from django.core.files import File
from myapp.models import ReportModel
import os

# 假设已生成CSV到/tmp/file.csv
csv_path = '/tmp/file.csv'
report = ReportModel()

# 打开文件并包装后传入
with open(csv_path, 'rb') as f:
    # save=False避免触发模型自动保存，留到后续调用自定义save方法
    report.csv_file.save('file.csv', File(f), save=False)
# 执行你自定义的save方法上传到S3
report.save()

# 清理临时文件
os.remove(csv_path)

方法2：为FileField指定S3存储后端 #

确保你的FileField明确绑定S3存储类，让Django直接用远程存储逻辑处理文件，绕开本地路径检查：

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

# 初始化S3存储实例
s3_storage = S3Boto3Storage()

class ReportModel(models.Model):
    # 绑定S3存储到FileField
    csv_file = models.FileField(storage=s3_storage)

    def save(self, *args, **kwargs):
        # 你的boto3自定义上传逻辑
        super().save(*args, **kwargs)

方法3：临时扩展MEDIA_ROOT（不推荐） #

可以临时将MEDIA_ROOT设为/tmp来绕过校验，但会带来安全风险，仅适合测试场景：

from django.conf import settings
from myapp.models import ReportModel

# 临时替换MEDIA_ROOT
original_media_root = settings.MEDIA_ROOT
settings.MEDIA_ROOT = '/tmp'

# 执行文件保存操作
report = ReportModel()
report.csv_file.save('file.csv', open('/tmp/file.csv', 'rb'))
report.save()

# 恢复原MEDIA_ROOT
settings.MEDIA_ROOT = original_media_root

额外提示 #

• 自定义save方法时，避免和Django默认的文件上传逻辑冲突，比如如果已经用boto3手动上传，就不要让Django重复处理。

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