You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Django项目中JavaScript与静态图片无法加载的问题求助

Django静态文件加载失败问题排查与解决建议

问题情况

  • 项目中所有JavaScript文件和图片均无法加载
  • 已尝试全局静态配置、应用级静态配置,均未解决问题
  • 静态文件已通过collectstatic收集到assets文件夹,assets与static文件夹内容完全一致

相关截图说明

  • 浏览器端截图:显示静态资源请求返回错误状态(如404)
  • settings.py及目录结构截图:展示项目静态相关配置项与目录层级
  • 终端截图:包含项目运行日志或静态文件收集操作的输出
  • assets文件夹截图:展示收集完成后的静态文件目录结构
  • static文件夹截图:展示项目原始静态文件的目录结构

相关代码

index.html代码

<!-- external javascripts -->
<script scr="{% static 'js/jquery.js' %}"></script>
<script scr="{% static 'js/jquery-ui.min.js' %}"></script>
<script scr="{% static 'js/bootstrap.min.js' %}"></script> -->
<!-- JS | jquery plugin collection for this theme -->
<script scr="{% static 'js/jquery-plugin-collection.js' %}"></script>
<!-- Revolution Slider 5.x SCRIPTS -->
<script scr="{% static 'js/revolution-slider/js/jquery.themepunch.tools.min.js' %}"></script>
<script scr="{% static 'js/revolution-slider/js/jquery.themepunch.revolution.min.js' %}"></script>

urls.py代码

from django.contrib import admin
from django.urls import path,include
from django.conf.urls.static import static
from . import settings
from user.views import home_view
urlpatterns = [
    path('admin/', admin.site.urls),
    path('',home_view, name='home'),
    path('faculty/', include('faculty.urls')),
    path('user/', include('user.urls'))

]+ static(settings.STATIC_URL,document_root=settings.STATIC_ROOT)

排查与解决步骤

  1. 修复模板标签缺失:确保HTML模板开头添加{% load static %},否则{% static %}标签无法被Django解析。
  2. 修正标签拼写错误:所有<script>标签中使用了错误的scr属性,必须改为正确的src,这是JS文件无法加载的直接原因。
  3. 验证静态配置正确性:
    • 检查settings.py中的静态配置项,确保格式正确:
      STATIC_URL = '/static/'
      STATIC_ROOT = os.path.join(BASE_DIR, 'assets')
      STATICFILES_DIRS = [
          os.path.join(BASE_DIR, 'static'),
      ]
      
    • 重新运行python manage.py collectstatic,确认静态文件完整收集到assets目录。
  4. 开发环境服务配置:开发阶段需保证DEBUG = True,Django会自动处理静态文件的托管;若DEBUG为False,需通过Nginx等外部Web服务器配置静态文件服务。
  5. 清理浏览器缓存:静态文件路径变更后,浏览器可能缓存旧地址,通过Ctrl+F5强制刷新页面测试。

内容的提问来源于stack exchange,提问作者Phalesh Mishra

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.02 15:41:46