Django导入static下style.css时终端返回404错误求助

核心问题分析 #

你在基础模板frame.html中通过{% static "main/css/style.css" %}加载样式文件时出现404错误，结合项目配置来看，问题根源在于静态文件目录的配置冲突，导致Django无法正确定位到你的CSS文件。

具体解决步骤 #

1. 调整静态文件目录配置（关键） #

你的settings.py中STATIC_ROOT指向了项目根目录的static文件夹，但这个目录是你手动存放静态文件的位置。STATIC_ROOT是Django生产环境下执行collectstatic命令时，收集所有应用静态文件的目标目录，不能提前手动存放文件，否则会干扰DEBUG模式下的静态文件查找逻辑。

修改settings.py中的静态文件配置：

STATIC_URL = 'static/'
# STATIC_ROOT保持不变，仅用于生产环境收集静态文件
STATIC_ROOT = BASE_DIR / 'static'
# 添加STATICFILES_DIRS，指定手动存放静态文件的目录
STATICFILES_DIRS = [
    BASE_DIR / 'staticfiles',  # 新建此目录，将原static下的main、admin文件夹迁移过来
]
STATICFILES_FINDERS = (
    'django.contrib.staticfiles.finders.FileSystemFinder',
    'django.contrib.staticfiles.finders.AppDirectoriesFinder',
)

完成后将项目根目录下的static文件夹重命名为staticfiles，确保staticfiles/main/css/style.css路径完整。

2. 修正模板静态文件引用语法 #

模板中的引用逻辑正确，但可以去掉不必要的单引号，保持标准写法：

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

3. 简化DEBUG模式下的URL配置 #

DEBUG模式下Django会自动处理静态文件服务，可移除urls.py中手动添加的静态文件路由，避免冲突：

urlpatterns = [
    path('', include('main.urls')),
    path('admin/', admin.site.urls),
] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
# 移除该行：+ static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

4. 重启服务验证 #

• 关闭当前Django开发服务器，重新启动
• 若之前执行过collectstatic命令，删除STATIC_ROOT目录下的所有文件，避免旧文件干扰

额外优化：修复媒体文件相对路径问题 #

你模板中的favicon使用了相对路径../media/main/win.png，在不同路由下会出现路径错误，建议改用Django媒体文件上下文处理器：

{% load static %}
<link rel="shortcut icon" href="{{ MEDIA_URL }}main/win.png" type="image/x-icon">

同时确保settings.py的模板上下文处理器中包含媒体文件处理器：

TEMPLATES = [
    {
        # 其他配置项
        'OPTIONS': {
            'context_processors': [
                # 其他处理器
                'django.template.context_processors.media',
            ],
        },
    },
]

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