django-pipeline集成S3Boto3Storage失败，执行collectstatic报错

问题描述 #

尝试将S3Boto3Storage与django-pipeline配合使用，因官方文档过时，调整存储类的包和类名后创建了如下存储类：

from django.contrib.staticfiles.storage import ManifestFilesMixin
from pipeline.storage import PipelineMixin
from storages.backends.s3boto3 import S3Boto3Storage

class S3PipelineManifestStorage(PipelineMixin, ManifestFilesMixin, S3Boto3Storage):
    pass

并在settings.py中配置：

STATICFILES_STORAGE = 'myproject.storages.S3PipelineManifestStorage'

执行python3 manage.py collectstatic时出现错误，最终提示FileNotFoundError: File does not exist: static/scss/adminmain.css。

请问：

1. 问题出在哪里？
2. 是否有人成功使用该组合，或是该功能在2022年已失效？

问题解答 #

1. 问题原因分析 #

• SCSS未完成编译：django-pipeline不会自动编译SCSS，必须配置对应的编译器并安装依赖。检查settings.py是否添加了SCSS编译配置：

  PIPELINE = {
      'COMPILERS': [
          'pipeline.compilers.sass.SASSCompiler',
      ],
      # 其他pipeline相关配置
  }
  

  同时需要安装libsass依赖：pip install libsass。若未配置编译环节，collectstatic会直接尝试处理未编译的SCSS文件，后续流程找不到对应编译后的CSS文件，触发报错。
• 存储类执行顺序冲突：虽然继承顺序（PipelineMixin在前负责编译，ManifestFilesMixin生成哈希文件名）看似正确，但S3Boto3Storage的云端上传逻辑可能在本地编译完成前就启动，导致找不到编译后的文件。可以先切换回本地静态存储（如ManifestStaticFilesStorage）执行collectstatic，确认是否能正常生成编译后的CSS文件，排除编译本身的问题。
• 静态文件目录配置错误：检查STATICFILES_DIRS是否包含存放adminmain.scss的目录，确保Django能定位到源文件。若源文件不在指定目录中，collectstatic无法找到文件，也会触发报错。
• 路径前缀不匹配：若S3存储配置了STATIC_URL或AWS_LOCATION前缀，可能导致pipeline生成的文件路径与S3存储期望的路径不一致，引发找不到文件的情况。

2. 组合可用性说明 #

该组合至今仍被大量开发者在生产环境中使用，2022年后并未失效。出现问题多为配置细节遗漏或版本兼容性问题：

• 需确保django-pipeline、django-storages与当前使用的Django版本兼容（比如Django 4.x/5.x对应的pipeline版本需≥2.0，storages版本需≥1.13）。
• 不少成功案例中，开发者会额外配置pipeline的STORAGE选项，明确编译后文件的临时存储位置，再由S3存储类统一上传到云端，避免路径冲突。

内容的提问来源于stack exchange，提问作者Philipp S.