Django开发阶段静态文件404|极客教程

Django开发阶段静态文件404

在Django开发的过程中，经常会遇到静态文件无法加载的情况，其中最常见的问题就是静态文件返回404错误。在本文中，我们将详细介绍在Django开发阶段遇到静态文件404错误的原因和解决方法。

问题描述

在Django项目中，通常会在settings.py中配置静态文件的路径，如下所示：

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

然后在urls.py中需要配置静态文件的路由，如下所示：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    path('admin/', admin.site.urls),
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

在以上配置完成后，我们可以在HTML文件中引入静态文件，例如：

<!DOCTYPE html>
<html>
<head>
    <title>Static file test</title>
    <link rel="stylesheet" type="text/css" href="{% static 'css/style.css' %}">
</head>
<body>
    <h1>Welcome to geek-docs.com</h1>
</body>
</html>

然而，在开发阶段中，有时候虽然配置和引入了静态文件，但在浏览器中依然会出现404错误，即无法加载静态文件的情况。下面我们将探讨可能的原因和解决方法。

可能原因

静态文件的路径错误
静态文件没被收集到根目录
Django的调试模式未开启

解决方法

确认静态文件路径

首先要确认在HTML文件中引入静态文件时使用的路径是否正确。比如在上面的示例中，静态文件的路径是css/style.css，那么在/static/css/目录下应该有style.css文件。如果路径错误，就会导致404错误。

收集静态文件

在Django中，静态文件需要被收集到指定的根目录，在需要在settings.py文件中配置静态文件的收集路径，如下所示：

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

然后使用以下命令将静态文件收集到根目录：

python manage.py collectstatic

开启调试模式

在开发阶段，建议将Django的调试模式开启，以便更方便地查看错误信息。在settings.py中将DEBUG设置为True：

DEBUG = True

这样，在出现404错误时，页面将会显示更详细的错误信息，帮助我们更快地定位问题。

示例代码

下面是一个完整的示例代码，包括了如何配置静态文件的路径、如何在HTML文件中引入静态文件以及如何收集静态文件：

settings.py中的配置：

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

urls.py中的配置：

from django.conf import settings
from django.conf.urls.static import static

urlpatterns = [
    path('admin/', admin.site.urls),
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)

在HTML文件中引入静态文件：

<!DOCTYPE html>
<html>
<head>
    <title>Static file test</title>
    <link rel="stylesheet" type="text/css" href="{% static 'css/style.css' %}">
</head>
<body>
    <h1>Welcome to geek-docs.com</h1>
</body>
</html>

使用命令收集静态文件：