Django 4.2.2未生效STORAGES['default']['BACKEND']设置求助

问题详情 #

• 在settings.py中配置了存储后端：

STORAGES = {
    "staticfiles": {
        "BACKEND": "storages.backends.s3boto3.S3Boto3Storage",
    },
    "mediafiles": {
        "BACKEND": "storages.backends.s3boto3.S3Boto3Storage",
    },
    "default": {
        "BACKEND": "storages.backends.s3boto3.S3Boto3Storage",
    },
}

• 执行代码打印默认存储后端：

from django.conf import settings
print('settings.DEFAULT_FILE_STORAGE', settings.DEFAULT_FILE_STORAGE)

• 输出结果：settings.DEFAULT_FILE_STORAGE django.core.files.storage.FileSystemStorage
• 现象：静态文件可正常写入S3，但媒体文件写入本地，推测是DEFAULT_FILE_STORAGE未正确覆盖导致。

解决思路 #

• 检查Django版本兼容性
  Django 4.2及以上版本才引入STORAGES配置项，若使用低于4.2的版本，STORAGES配置不会生效，需改用旧版配置方式：

  DEFAULT_FILE_STORAGE = "storages.backends.s3boto3.S3Boto3Storage"
  STATICFILES_STORAGE = "storages.backends.s3boto3.S3Boto3Storage"
  

• 排查配置覆盖问题

  • 检查项目中是否存在其他配置文件（如local_settings.py）或环境变量，是否在主配置之后重置了DEFAULT_FILE_STORAGE。
  • 确认STORAGES配置代码位置，避免被后续代码重新赋值覆盖。

• 显式绑定媒体文件存储后端
  在Django 4.2+版本中，可直接指定媒体文件对应的存储配置，确保关联生效：

  MEDIA_STORAGE = "storages.backends.s3boto3.S3Boto3Storage"
  

  也可以在模型字段中直接指定存储类：

  from django.db import models
  from storages.backends.s3boto3 import S3Boto3Storage
  
  media_storage = S3Boto3Storage()
  
  class YourModel(models.Model):
      media_file = models.FileField(storage=media_storage)
  

• 验证依赖版本
  确保django-storages包为最新稳定版，避免因版本不兼容导致STORAGES配置无法识别。

• 清理缓存并重启服务
  修改配置后，删除项目中的__pycache__文件夹，重启Django服务，确保新配置生效。

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