执行Empty Cache and Hard Reload后Django静态文件加载失败（404）求助

问题原因分析 #

你遇到的静态文件404问题，核心是DEBUG模式下静态文件配置的冲突：

• STATIC_ROOT是生产环境用来收集所有静态文件的目录，DEBUG=True时Django不会用这个目录提供静态文件，它只会从各App的static子目录或STATICFILES_DIRS配置的目录读取静态文件。
• 你的配置仅设置了STATIC_ROOT，未配置STATICFILES_DIRS，且urls.py未在DEBUG模式下添加静态文件的URL映射。清除缓存后，浏览器无法再获取缓存的静态文件路径，直接触发404错误。

解决方案 #

1. 修正settings.py的静态文件配置 #

修改settings.py，添加STATICFILES_DIRS并调整STATIC_ROOT的使用：

# settings.py
DEBUG = True

ALLOWED_HOSTS = []

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'Category',
    'accounts',
    'store',
    'cart',
]

STATIC_URL = '/static/'
# DEBUG模式下无需启用STATIC_ROOT，可注释或保留（仅collectstatic命令使用）
# STATIC_ROOT = os.path.join(BASE_DIR, 'static')

# 添加STATICFILES_DIRS，指向你存放静态文件的目录（比如项目根目录下的static文件夹）
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, 'static'),
]

2. 完善urls.py的静态文件映射 #

在urls.py中添加DEBUG模式下的静态文件路由映射，确保Django能正确处理静态文件请求：

# urls.py
from django.conf import settings
from django.conf.urls.static import static
from django.contrib import admin
from django.urls import include, path
from .views import index  # 确保index视图已正确导入

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', index, name='index'),
    path('store/', include('store.urls')),
    path('cart/', include('cart.urls')),
    path('accounts/', include('accounts.urls')),
] 

# DEBUG模式下添加静态文件和媒体文件的路由
if settings.DEBUG:
    urlpatterns += static(settings.STATIC_URL, document_root=settings.STATICFILES_DIRS[0])
    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

3. 验证静态文件路径 #

确认静态文件实际存在：

• 检查项目根目录下的static/js/bootstrap.bundle.min.js、static/js/jquery-2.0.0.min.js等文件是否存在
• 确保文件路径与模板中{% static %}标签引用的路径完全匹配

4. 重启Django服务 #

修改配置后，重启本地开发服务器，再刷新浏览器即可，无需再次清除缓存，静态文件应能正常加载。

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