Django中静态文件CSS加载失败，请求协助排查问题

1. 静态文件配置冲突问题 #

你的settings.py中STATIC_ROOT和STATICFILES_DIRS路径存在冲突：

• STATIC_ROOT是collectstatic命令收集静态文件的目标目录，不能和STATICFILES_DIRS里的目录重复。
• 当前STATIC_ROOT = os.path.join(BASE_DIR, 'static')，而STATICFILES_DIRS指向userController/static/，若BASE_DIR下的static目录存在，会导致静态文件查找逻辑混乱。

修复配置：

# demowebsite/settings.py
import os
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

# 开发环境下注释STATIC_ROOT，生产环境执行collectstatic前再启用
# STATIC_ROOT = os.path.join(BASE_DIR, 'static')

STATIC_URL = '/static/'
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'userController/static/'),
]

2. HTML模板语法错误 #

dashboard.html存在两处问题：

• 使用{% extends 'base.html' %}后，无需重复编写<html>、<head>标签，这些结构应由base.html提供，否则会导致HTML结构混乱。
• HTML注释需用<!-- 注释内容 -->，而非/* */（这是CSS/JS的注释语法）。

修复后的模板代码：

{% extends 'base.html' %}
{% load static %}

{% block head %}
    <!-- 加载CSS -->
    <link rel="stylesheet" href="{% static 'css/dashboard.css' %}">
{% endblock %}

（需确保base.html中定义了{% block head %}或对应可插入的区块名称）

3. 验证静态文件路径 #

确认静态文件实际存放路径为userController/static/css/dashboard.css，与配置及模板引用路径一致。

4. 开发环境调试 #

开发环境下确保DEBUG = True，Django会自动处理静态文件服务。可直接访问http://localhost:8000/static/css/dashboard.css：

• 若能查看CSS内容，说明配置无问题，需检查模板引用逻辑；
• 若返回404，重新核对文件路径与配置项。

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