Django中Whitenoise在DEBUG=False时无法正常工作的问题

你的核心问题是Whitenoise中间件位置错误，加上缺少必要配置项导致静态资源无法加载。以下是具体修复步骤：

1. 修正中间件顺序 #

Whitenoise中间件必须放在SecurityMiddleware之后、SessionMiddleware之前，这是官方强制要求的加载顺序。修改settings.py中的MIDDLEWARE配置：

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'whitenoise.middleware.WhiteNoiseMiddleware',  # 移至此处
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
]

2. 添加必要的INSTALLED_APPS配置 #

在settings.py的INSTALLED_APPS中，将whitenoise.runserver_nostatic放在django.contrib.staticfiles之前，确保本地测试时Django自带的runserver不会拦截静态资源请求：

INSTALLED_APPS = [
    # 其他应用...
    'whitenoise.runserver_nostatic',
    'django.contrib.staticfiles',
    # 其他应用...
]

3. 配置静态资源存储（可选但推荐） #

添加以下配置到settings.py，优化静态资源的缓存和加载：

STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'

4. 重新收集静态资源并重启服务器 #

执行命令重新收集静态资源：

python manage.py collectstatic

完成后重启本地Web服务器。

补充说明 #

• DEBUG=False时，Django的static()路由辅助函数不会生效，但Whitenoise会自动处理STATIC_ROOT目录下的所有静态资源请求，无需在urls.py中额外配置静态资源路由。
• 若问题仍存在，检查BASE_DIR是否正确指向项目根目录，确保STATIC_ROOT路径无误。

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