Django项目执行collectstatic后CSS无法加载问题排查

核心问题：模板中静态文件路径错误 #

你的base.html里的CSS引用存在路径冗余：

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

{% static %}标签会自动拼接settings.py中STATIC_URL的值（当前为static/），这会导致最终生成的路径是static/static/css/style.css，而collectstatic后实际的CSS文件路径是static/css/style.css，自然无法加载。

修正写法：

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

额外验证点 #

1. 确认静态文件是否被正确收集
   检查项目根目录下的static文件夹（即STATIC_ROOT指向的目录），确认css/style.css文件存在。如果不存在：

   • 检查是否配置了STATICFILES_DIRS，指定原始静态文件的存放位置（比如项目根目录的assets文件夹或app下的static目录），否则collectstatic找不到需要收集的源文件。
   • 重新执行python manage.py collectstatic，留意命令输出是否有文件收集的记录，是否存在报错。

2. URL配置的生效范围
   你添加的static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)仅在DEBUG=True的开发环境中生效。如果是生产环境（DEBUG=False），Django不会处理静态文件请求，需要通过Nginx、Apache等Web服务器配置静态文件托管，确保服务器指向STATIC_ROOT目录。

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