升级至Django 1.11后collectstatic生成空文件问题求助

我之前升级Django版本时也碰到过类似的collectstatic和S3存储兼容的坑，结合你的版本变化和配置，给你几个实用的排查和解决方向：

• 调整ManifestFilesMixin的元数据配置
  Django 1.11对ManifestFilesMixin的元数据处理逻辑和1.8有差异，你设置的preload_metadata = True可能会和S3的文件元数据读取产生冲突。可以先尝试将其改为False，同时明确指定bucket信息：

  class StaticS3BotoStorage(ManifestFilesMixin, S3BotoStorage):
      location = 'static'
      file_overwrite = True
      preload_metadata = False
  
      def __init__(self, *args, **kwargs):
          super().__init__(*args, **kwargs)
          self.bucket_name = settings.AWS_STORAGE_BUCKET_NAME
  

• 适配django-storages 1.6.x的路径处理变化
  新版本的django-storages对location和base_url的耦合更严格，容易和ManifestFilesMixin的哈希文件名生成逻辑冲突。建议在settings里明确配置静态资源的域名：

  AWS_S3_CUSTOM_DOMAIN = f'{settings.AWS_STORAGE_BUCKET_NAME}.s3.amazonaws.com'
  STATIC_URL = f'https://{AWS_S3_CUSTOM_DOMAIN}/static/'
  

  然后在存储类中补充base_url配置：

  class StaticS3BotoStorage(ManifestFilesMixin, S3BotoStorage):
      location = 'static'
      file_overwrite = True
      preload_metadata = True
      base_url = settings.STATIC_URL
  

• 替换过时的CachedFilesMixin
  Django 1.11里CachedFilesMixin已经被标记为过时，官方推荐使用ManifestFilesMixin代替。如果你还在混用两个Mixin，建议完全切换到ManifestFilesMixin，同时清理S3上的旧静态文件和本地的manifest缓存（staticfiles.json），避免哈希值冲突导致的文件找不到问题。

• 检查S3权限和桶配置
  django-storages 1.6.x对S3的权限要求更细致，确保你的AWS IAM用户拥有s3:PutObject、s3:GetObject、s3:ListBucket这三个核心权限，同时桶的CORS配置要允许静态资源的跨域访问（如果你的前端是跨域访问的话）。

• 强制清理旧文件重新收集
  尝试带上--clear参数清理旧的静态文件，再执行collectstatic：

  python manage.py collectstatic --clear --noinput
  

如果以上方法都没解决问题，建议查看collectstatic的完整错误日志，定位具体是哪个文件或步骤出错——比如是不是某个静态文件的哈希生成失败，或者S3连接超时之类的细节，能更快找到根源。

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