集成Wagtail的Django生产环境admin与wagtail后台静态文件丢失问题

你遇到的问题是生产环境下Django admin、Wagtail后台静态文件加载失败，核心原因基本为Whitenoise配置错误或路由规则问题，按以下步骤排查修复即可：

1. 修正Whitenoise中间件配置 #

生产环境静态文件由Whitenoise中间件直接处理，需确保中间件顺序正确，在settings.py的MIDDLEWARE列表中，将Whitenoise中间件放在SecurityMiddleware之后、其他所有中间件之前：

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    # 新增/调整到这个位置
    'whitenoise.middleware.WhiteNoiseMiddleware',
    # 其他中间件
    'django.contrib.sessions.middleware.SessionMiddleware',
    ...
]

2. 修正urlpatterns拼接语法错误 #

你当前的路由拼接写法存在Python语法问题，换行的+ static(...)未被识别为urlpatterns的一部分，需修正拼接逻辑：

urlpatterns = [
    path('admin/', admin.site.urls),
    path('accounts/', include('allauth.urls')),
    path('', views.home, name='home'),
    path('clubs/', include('clubs.urls', namespace="clubs")),
    path('members/', include('members.urls', namespace="members")),
    path('videos/', include('videos.urls', namespace="videos")),
    path('cms/', include(wagtailadmin_urls)),
    path('documents/', include(wagtaildocs_urls)),
    path('blog/', include(wagtail_urls)),
    path('posts/', include(puput_urls)),
] + static(settings.STATIC_URL, document_root=settings.STATIC_ROOT) + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

# 更清晰的可选写法：
# urlpatterns = [
#     ... 你的原有路由 ...
# ]
# urlpatterns += static(settings.STATIC_URL, document_root=settings.STATIC_ROOT)
# urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)

3. 确认生产环境静态文件逻辑正确 #

Django自带的static()辅助函数生成的静态路由仅在DEBUG=True时生效，生产环境DEBUG=False时无需依赖这部分路由处理静态文件，正确配置Whitenoise中间件后，它会自动映射STATIC_URL路径到STATIC_ROOT下的所有文件，你已经收集到staticfiles目录下的admin、wagtailadmin静态文件都会被正常访问。

可选排查项 #

如果仍有问题，可临时修改STATICFILES_STORAGE配置，排查是否为Manifest哈希映射异常：

# 临时替换原有配置，验证是否为资源哈希问题
STATICFILES_STORAGE = 'whitenoise.storage.CompressedStaticFilesStorage'

每次修改配置后需重新执行python manage.py collectstatic --noinput刷新静态资源。

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