Django中CSS文件加载失败问题求助

问题场景 #

• 已将style.css放置在项目根目录的static文件夹中
• 访问页面或直接在浏览器中打开http://127.0.0.1:8000/static/style.css时，返回404错误

相关配置与代码 #

文件夹结构 #

base.html代码（路径：reviews > templates > reviews > base.html） #

{% load static %}
<!DOCTYPE html>
<html lang="en">
    <head>            
        <link rel="stylesheet" href="{% static "style.css" %}" />
    </head>        
</html>

settings.py配置（路径：Feedback > Feedback > settings.py） #

STATIC_URL = '/static/'

STATICFILES_DIRS = [
    BASE_DIR / "static",

]

错误信息 #

GET http://127.0.0.1:8000/static/style.css net::ERR_ABORTED 404 (Not Found)

排查与解决方法 #

1. 确认文件路径准确性
   检查项目根目录下的static文件夹是否存在，style.css是否确实在该文件夹内。注意Linux/macOS环境下区分大小写，避免出现Static和static混淆的情况。

2. 验证BASE_DIR指向
   在settings.py中添加打印语句，确认BASE_DIR的实际路径：

   print(BASE_DIR)
   

   运行项目后查看控制台输出，确保BASE_DIR确实指向项目根目录，这样BASE_DIR / "static"才能正确定位到你的静态文件夹。

3. 修正STATICFILES_DIRS格式
   移除配置末尾多余的逗号（Python语法允许但易引发潜在问题），修改为：

   STATICFILES_DIRS = [
       BASE_DIR / "static",
   ]
   

4. 检查DEBUG模式状态
   开发环境下需确保DEBUG设置为True，Django才会自动处理静态文件服务：

   DEBUG = True
   

   若DEBUG为False，需通过Nginx等工具手动配置静态文件服务（生产环境标准做法）。

5. 执行collectstatic排查（可选）
   运行以下命令，将静态文件收集到STATIC_ROOT指定目录（若配置），验证文件是否能被Django识别：

   python manage.py collectstatic
   

6. 重启开发服务器
   修改settings.py后，必须重启Django开发服务器，确保配置生效。

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