使用Cloudinary托管Django应用静态文件时遇TypeError报错求助

问题根源 #

报错TypeError: expected str, bytes or os.PathLike object, not NoneType来自cloudinary_storage/storage.py的hashed_name方法，核心原因是：Whitenoise中间件尝试读取本地静态文件路径，但Cloudinary静态存储类不会返回本地文件路径，导致absolute_path为None。

解决方案 #

1. 移除Whitenoise中间件 #

如果静态文件完全托管在Cloudinary，无需Whitenoise处理本地静态文件，直接从settings.py的MIDDLEWARE中移除相关条目：

# settings.py
MIDDLEWARE = [
    # 移除该行
    # 'whitenoise.middleware.WhiteNoiseMiddleware',
    ...其他中间件...
]

2. 验证Cloudinary静态存储配置 #

确保settings.py中静态存储相关配置正确：

# settings.py
INSTALLED_APPS = [
    ...
    'cloudinary_storage',
    'cloudinary',
    'django.contrib.staticfiles',
    ...
]

# Cloudinary核心配置
CLOUDINARY_STORAGE = {
    'CLOUD_NAME': '你的Cloudinary云名称',
    'API_KEY': '你的API密钥',
    'API_SECRET': '你的API密钥'
}

# 指定静态文件存储类
STATICFILES_STORAGE = 'cloudinary_storage.storage.StaticHashedCloudinaryStorage'

3. 上传静态文件到Cloudinary #

执行collectstatic命令，将本地静态文件同步到Cloudinary：

python manage.py collectstatic

4. 开发环境适配（可选） #

若在DEBUG模式下开发，不想频繁上传静态文件到Cloudinary，可临时切换回本地存储：

# settings.py
if DEBUG:
    STATICFILES_STORAGE = 'django.contrib.staticfiles.storage.StaticFilesStorage'
    STATIC_URL = '/static/'

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