Django Collectstatic 为何仅存静态文件到本地STATIC_ROOT而非S3？

• 修复存储类配置错误
  你的STATICFILES_STORAGE和DEFAULT_FILE_STORAGE直接引用了类对象，Django要求配置项必须是字符串形式的Python模块路径。修改配置如下：

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

• 验证环境变量加载状态
  在settings.py开头添加临时打印代码，确认所有AWS相关环境变量均正确加载：

  print("AWS_ACCESS_KEY_ID:", os.getenv('AWS_ACCESS_KEY_ID'))
  print("AWS_STORAGE_BUCKET_NAME:", os.getenv('AWS_STORAGE_BUCKET_NAME'))
  print("AWS_S3_REGION_NAME:", os.getenv('AWS_S3_REGION_NAME'))
  

  执行python manage.py collectstatic --clear，查看控制台输出的变量值是否与预期一致，排除.env文件路径错误或变量名拼写问题。

• 确保django-storages依赖完整
  确认安装的是包含boto3适配的django-storages版本，执行以下命令重新安装：

  pip install django-storages[boto3]
  

  避免仅安装基础版django-storages导致缺少S3所需的依赖组件。

• 查看详细运行日志
  执行collectstatic时启用最高级别的日志输出，观察是否有S3相关的操作记录：

  python manage.py collectstatic --clear --verbosity 3
  

  如果日志中完全没有出现boto3或S3相关的操作信息，说明存储类配置未生效，需检查是否有其他settings文件（如production.py）覆盖了当前配置。

• 检查静态文件目录配置
  若你的静态文件存放在app目录外的自定义路径，需添加STATICFILES_DIRS配置，确保collectstatic能扫描到所有需要上传的文件：

  STATICFILES_DIRS = [
      os.path.join(BASE_DIR, 'custom_static'),
  ]
  

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