生产环境Django静态文件错误指向Heroku，未从Cloudinary加载

核心问题 #

生产环境下{% static %}标签生成Heroku域名下的静态文件路径（如https://coach-matrix-d2cd1e717f81.herokuapp.com/static/css/style.css），而非预期的Cloudinary CDN路径，导致404错误，但静态文件已成功上传至Cloudinary媒体库。

关键配置核查与修复步骤 #

1. 确认STATIC_URL与Cloudinary的关联配置 #

在settings.py的生产环境分支中，必须将STATIC_URL直接指向Cloudinary的静态资源前缀，而非默认的相对路径/static/。推荐两种配置方式：

• 手动拼接Cloudinary地址：

import os
import cloudinary

cloudinary.config(
    cloud_name=os.environ.get('CLOUDINARY_CLOUD_NAME'),
    api_key=os.environ.get('CLOUDINARY_API_KEY'),
    api_secret=os.environ.get('CLOUDINARY_API_SECRET'),
    secure=True
)

# 生产环境STATIC_URL配置
STATIC_URL = f'https://res.cloudinary.com/{os.environ.get("CLOUDINARY_CLOUD_NAME")}/raw/upload/v{cloudinary.utils.timestamp()}/static/'

• 使用Cloudinary官方Django存储类自动生成：

from cloudinary_storage.storage import RawMediaCloudinaryStorage

STATICFILES_STORAGE = 'cloudinary_storage.storage.StaticHashedCloudinaryStorage'
STATIC_URL = RawMediaCloudinaryStorage().base_url + 'static/'

注意：生产环境的STATIC_URL必须是Cloudinary的绝对地址，不能保留相对路径。

2. 验证STATICFILES_STORAGE配置 #

确保生产环境下已替换默认存储类为Cloudinary的静态文件存储后端：

# settings.py中生产环境分支
if not DEBUG:
    STATICFILES_STORAGE = 'cloudinary_storage.storage.StaticHashedCloudinaryStorage'

这个配置是核心——它既让collectstatic命令将静态文件上传至Cloudinary，也会让{% static %}标签自动生成Cloudinary的CDN路径。

3. 检查Heroku环境变量与collectstatic执行状态 #

• 确认Heroku上已正确配置CLOUDINARY_CLOUD_NAME、CLOUDINARY_API_KEY、CLOUDINARY_API_SECRET三个环境变量，无拼写错误。
• 禁止设置DISABLE_COLLECTSTATIC=1，生产环境必须让Heroku自动执行collectstatic。可通过Heroku CLI验证：

heroku config:get DISABLE_COLLECTSTATIC

若返回1，执行以下命令解除限制：

heroku config:unset DISABLE_COLLECTSTATIC

4. 强制刷新Heroku部署配置 #

环境变量或配置变更可能未自动生效，需触发重新部署：

git commit --allow-empty -m "Force redeploy to refresh config"
git push heroku main

部署完成后，查看日志确认collectstatic正常执行：

heroku logs --tail | grep collectstatic

确保日志中无报错，且显示静态文件已成功上传至Cloudinary。

5. 模板标签的规范使用 #

确保模板开头已正确加载静态标签，且未混用硬编码路径：

{% load static %}
<link rel="stylesheet" href="{% static 'css/style.css' %}">

额外排查点 #

• 检查settings.py中是否有其他代码（如第三方库自动配置）在生产环境下覆盖了STATIC_URL或STATICFILES_STORAGE。
• 核对Cloudinary媒体库中静态文件的路径（含哈希后缀，如style.674a1e0f7f03.css）与{% static %}预期生成的路径是否一致。

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