存储ContentFile时Django FileField抛出AttributeError问题排查

问题描述 #

我通过传入字符串创建了一个ContentFile实例，并尝试按如下方式将其保存到模型中：

def generate_file_path(instance, filename):
    path = f"{instance.name}/{instance.field}_{filename}"
    return path

class SampleModel(models.Model):
    name = CharField(max_length=50)
    field = CharField(max_length=100)
    upload = models.FileField(
        _("Skan"),
        storage=settings.FILE_STORAGE,
        upload_to=generate_file_path
    )

file = ContentFile('sample content', name='file.txt')
instance = SampleModel(upload=file, name='name', field='field_info')
instance.save()

但保存时抛出错误：
AttributeError: 'str' object has no attribute 'generate_filename'

我认为FileField应该可以处理ContentFile实例，请问哪里操作出错了？

原因分析 #

错误的核心原因是你配置的settings.FILE_STORAGE是字符串类型（比如存储类的模块路径字符串），而非实例化的存储对象。

当Django处理FileField的文件保存时，会调用存储对象的generate_filename方法来生成文件路径，但如果storage参数传入的是字符串，Django无法直接调用该方法，就会抛出'str' object has no attribute 'generate_filename'的错误。

解决方法 #

有两种可行的修正方式：

方式一：在模型中实例化存储类 #

修改模型的FileField配置，给settings.FILE_STORAGE添加括号，将字符串路径对应的存储类实例化：

upload = models.FileField(
    _("Skan"),
    storage=settings.FILE_STORAGE(),  # 添加括号完成实例化
    upload_to=generate_file_path
)

方式二：在settings中直接配置实例化的存储对象 #

在settings.py中导入存储类并直接实例化，而不是用字符串路径：

# settings.py
from django.core.files.storage import FileSystemStorage
# 替换为你的存储路径和配置
FILE_STORAGE = FileSystemStorage(location='/your/storage/path')

这样配置后，settings.FILE_STORAGE就是一个实例化的存储对象，Django可以正常调用其generate_filename方法，ContentFile也能正确保存到模型中。

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