为什么Django开发环境下CSS正常加载但图片、JS返回404
Django 静态资源部分加载失败排查
核心根因
静态资源引用路径和STATICFILES_DIRS配置不匹配。
逻辑说明
Django开启DEBUG模式运行开发服务器时,处理静态请求的逻辑为:
- 收到
/static/xxx格式的请求后,遍历STATICFILES_DIRS中配置的所有目录 - 在每个配置目录下拼接
xxx相对路径,找到匹配文件则直接返回
你的配置中STATICFILES_DIRS = [os.path.join(BASE_DIR, 'assets')],代表Django的静态查找根路径包含项目根目录下的assets文件夹。
而你模板中图片的引用代码:
<img class="logo" src="{% static 'assets/base/img/logo/logo.jpg' %}">
会被解析成请求路径/static/assets/base/img/logo/logo.jpg,对应本地实际查找路径为BASE_DIR/assets/assets/base/img/logo/logo.jpg,多嵌套了一层assets目录,和实际文件结构不匹配,因此返回404。
CSS能正常加载的原因是:你编写CSS引用时没有多加assets/前缀,对应查找路径刚好匹配实际文件位置。
修复方案
- 修改模板中所有静态资源的引用路径,去掉开头多余的
assets/前缀,例如图片引用修改为:
<img class="logo" src="{% static 'base/img/logo/logo.jpg' %}">
- 所有JS、图片资源的引用都遵循该规则,不要额外加
assets/前缀,因为该目录已经被配置为静态查找根路径。
补充排查项
如果修改路径后仍有部分资源404,可依次检查:
- 确认项目配置中
DEBUG = True,Django只有DEBUG开启时才会自动处理静态文件请求 - 核对文件名、目录名的大小写,避免出现拼写不一致的问题
- 确认对应JS、图片文件确实存在于推导的实际路径下,没有文件遗漏或拼写错误
内容的提问来源于stack exchange,提问作者Ross
相关产品推荐
相关产品推荐

