Django项目中Cloudinary与SCSS预处理器配置冲突求助

一、修复TypeError: MediaCloudinaryStorage.__init__() got an unexpected keyword argument 'ROOT' #

这个错误源于媒体存储配置错误，MediaCloudinaryStorage不需要ROOT参数，需确保静态存储与媒体存储配置完全分离：

1. 修正settings.py中的存储配置：

# 静态文件存储（CSS、JS等）
STATICFILES_STORAGE = 'cloudinary_storage.storage.StaticHashedCloudinaryStorage'
# 媒体文件存储（用户上传文件）
DEFAULT_FILE_STORAGE = 'cloudinary_storage.storage.MediaCloudinaryStorage'

# 删除针对MediaCloudinaryStorage的ROOT相关配置，比如：
# MEDIA_ROOT = ...  # 使用Cloudinary媒体存储时无需本地MEDIA_ROOT

2. 适配SCSS处理器与Cloudinary存储：
   SCSS需先在本地编译为CSS，再通过collectstatic上传到Cloudinary，需配置sass_processor的输出目录指向静态文件夹：

# settings.py中添加sass_processor配置
SASS_PROCESSOR_ROOT = os.path.join(BASE_DIR, 'static')
SASS_OUTPUT_STYLE = 'compressed'

二、修复ValueError: Couldn't load manifest 'staticfiles.json' (version 1.0) #

该错误因缺少SCSS编译后的静态文件，或manifest文件未正确生成导致：

1. 保留STATICFILES_FINDERS配置，不要注释：

STATICFILES_FINDERS = [
    'django.contrib.staticfiles.finders.FileSystemFinder',
    'django.contrib.staticfiles.finders.AppDirectoriesFinder',
    'sass_processor.finders.CssFinder',
]

2. 重新编译SCSS并收集静态文件：

# 编译SCSS（若sass_processor未自动编译）
python manage.py compilescss
# 清除旧静态文件并重新收集（会自动上传到Cloudinary）
python manage.py collectstatic --clear

执行前确保CLOUDINARY_STORAGE中的cloud_name、api_key、api_secret配置正确，这样会生成有效的staticfiles.json manifest。

三、修复升级cloudinary_storage时的包找不到问题 #

此问题多因pip源或版本兼容导致：

1. 先升级pip到最新版本：

python -m pip install --upgrade pip

2. 使用国内镜像源安装/升级：

pip install --upgrade cloudinary_storage cloudinary -i https://pypi.tuna.tsinghua.edu.cn/simple

注：cloudinary_storage依赖cloudinary包，需同时操作两者。

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