Django无法从根目录staticfiles导入CSS/JS文件报404如何解决

• 模板中硬编码的静态资源路径完全错误：你配置的静态资源对外访问前缀是STATIC_URL = '/static/'，但你写的引用路径是/User_Authentication/staticfiles/admin/css/responsive.css——staticfiles是服务器本地存放collectstatic输出文件的目录名，不是对外暴露的URL路径段，Django的静态路由只会匹配/static/开头的请求，路径不对必然返回404。
• 模板未加载Django静态文件模板标签，且错误将本地文件系统路径当成web访问路径使用。STATIC_ROOT指向的目录是后端存储用的，永远不应该直接出现在前端的资源引用URL里。
• 存在冗余的路由重复配置：根路由和app路由里重复添加了静态资源匹配规则，虽然不是404的直接诱因，但无意义的重复配置容易引发路由匹配异常。

1. 修正模板静态资源引用
   打开base.html，首先删除模板最开头无意义的{% csrf_token %}标签（该标签仅在POST表单内生效，全局放置无任何作用），然后在所有模板代码最开头（DOCTYPE声明之前）加载静态标签，替换错误的硬编码资源路径：

   {% load static %}
   {% load crispy_forms_tags %}
   <!DOCTYPE html>
   <html lang="en">
   <head>
       <meta charset="UTF-8">
       <meta http-equiv="X-UA-Compatible" content="IE=edge">
       <meta name="viewport" content="width=device-width, initial-scale=1.0">
       <!-- 删除原来硬编码路径的link标签，替换为静态标签写法 -->
       <link rel="stylesheet" href="{% static 'admin/css/responsive.css' %}">
   </head>
   

   注意：{% static %}标签后只需要写文件相对于staticfiles目录的相对路径即可，不需要加任何项目名、static、staticfiles前缀，标签会自动按照你配置的STATIC_URL拼接出正确的访问地址。

2. 清理冗余路由配置
   打开accounts应用下的urls.py，删除重复添加的静态路由代码，只保留根urls.py中的静态路由配置即可：

   # 删除accounts/urls.py中的以下两行
   urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
   urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
   

3. 确认服务运行配置

   • 本地测试时先把settings.py中的DEBUG = True打开，Django自带的static()辅助路由仅在DEBUG模式下生效，生产模式默认不会代理静态文件。
   • 重新执行python manage.py collectstatic确认所有静态文件收集完整，确认staticfiles/admin/css/responsive.css文件确实存在。

4. 验证访问
   启动服务后按Ctrl+F5强制刷新浏览器清缓存，查看浏览器请求的静态资源地址，正常的请求路径应该是/static/admin/css/responsive.css，该路径会命中你配置的静态路由，直接返回对应文件，不再报404。

注意：不要把staticfiles目录加入STATICFILES_DIRS配置，STATICFILES_DIRS是存放你项目自定义的原始静态文件的目录，staticfiles是collectstatic生成的输出目录，混入会导致静态文件重复收集、路径异常。

内容的提问来源于stack exchange，提问作者Noor ul ain Ibrahim