如何在Django settings.py中配置STATIC_URL适配CDN？

我来帮你排查这个问题，大概率是几个容易忽略的配置细节导致的，一步步来梳理：

1. 先确认模板是否加载了static标签 #

这是最常见的“低级错误”！在你使用{% static 'picture_small.jpg' %}的模板文件顶部（或者继承的父模板顶部），必须添加：

{% load static %}

Django不会自动加载这个标签，没加的话模板解析会失败，自然生成不了正确的URL。

2. 验证Heroku环境变量是否被Django正确读取 #

你在Heroku上设置了STATIC_URL变量，但要确保Django的settings.py确实在读取这个环境变量。正确的写法应该是：

import os

# 优先读取环境变量，本地开发用默认值兜底
STATIC_URL = os.environ.get('STATIC_URL', '/static/')

可以通过Heroku控制台验证变量是否生效：

heroku run python manage.py shell

然后在shell里输入：

from django.conf import settings
print(settings.STATIC_URL)

如果输出不是你设置的CloudFront地址，说明环境变量没被正确加载，检查Heroku的变量设置是否拼写正确（比如有没有大小写错误）。

3. 检查STATIC_URL的格式是否正确 #

你的STATIC_URL末尾已经带了斜杠（https://my_cloud_front_adress.cloudfront.net/staticfiles/），这是正确的——{% static %}标签会自动把文件名拼接到后面，生成预期的完整URL。如果生成的URL格式不对（比如少了斜杠），再回头检查STATIC_URL的设置是否有误。

4. 排查静态文件存储后端的影响 #

如果你在settings.py里配置了STATICFILES_STORAGE（比如用ManifestStaticFilesStorage做静态文件哈希），要确保这个存储后端没有覆盖STATIC_URL的配置。默认情况下，django.contrib.staticfiles.storage.StaticFilesStorage会直接使用STATIC_URL作为基础路径；如果用了自定义存储类，检查它的base_url属性是否正确指向你的CloudFront地址。

5. 缓存和CloudFront配置检查 #

• 浏览器缓存：有时候旧的静态文件路径被缓存了，尝试清除浏览器缓存或者用隐私模式打开页面测试。
• CloudFront配置：确认你的CloudFront分发确实指向了存储静态文件的源（比如S3桶），并且picture_small.jpg确实存在于staticfiles/目录下，文件权限是公开可读的。

最后一步：本地测试复现 #

把本地settings.py里的STATIC_URL临时改成CloudFront的地址，运行本地服务器，看模板生成的URL是否正确、图片能否加载。如果本地正常，那问题肯定出在Heroku的环境变量读取或者部署配置上；如果本地也不行，那就是本地模板或配置的问题。

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