升级Wagtail后登录状态下静态资源返回404问题求助

核心问题定位 #

根据描述，有效session存在时静态资源返回404，无效/无session时正常，结合测试现象，问题大概率出在中间件顺序错误或认证相关中间件拦截静态资源请求。

步骤1：调整中间件顺序 #

当前中间件中，SecurityMiddleware和WhiteNoiseMiddleware的位置不符合Django官方规范，这会导致认证/会话中间件先处理静态资源请求，干扰Whitenoise的正常工作。

修改MIDDLEWARE配置为如下顺序：

MIDDLEWARE = [
    # 安全中间件必须放在最前面
    "django.middleware.security.SecurityMiddleware",
    # Whitenoise紧随安全中间件之后，优先处理静态资源请求
    "whitenoise.middleware.WhiteNoiseMiddleware",
    "django.contrib.sessions.middleware.SessionMiddleware",
    "django.middleware.common.CommonMiddleware",
    "django.middleware.csrf.CsrfViewMiddleware",
    "django.contrib.auth.middleware.AuthenticationMiddleware",
    "wagtail_2fa.middleware.VerifyUserMiddleware",
    "django.contrib.messages.middleware.MessageMiddleware",
    "django.middleware.clickjacking.XFrameOptionsMiddleware",
    "wagtail.contrib.redirects.middleware.RedirectMiddleware",
]

步骤2：修复STATIC_URL配置 #

避免使用绝对URL作为STATIC_URL，改用带根路径的相对路径，确保静态资源路径解析一致：

# 开发/生产环境统一设置
STATIC_URL = "/static/"

步骤3：排除静态资源的2FA验证拦截 #

wagtail_2fa的VerifyUserMiddleware可能会拦截静态资源请求（即使已登录），添加排除规则确保静态资源不被2FA中间件处理：

# 在settings中添加
WAGTAIL_2FA_EXCLUDE_URLS = [
    r'^static/',
    r'^favicon\.ico$',  # 可选：排除图标文件
]

步骤4：验证配置并重新部署 #

1. 重新执行collectstatic命令：

python manage.py collectstatic --noinput

2. 重启服务，测试登录前后静态资源访问情况。

额外排查点 #

• 检查是否有自定义URL路由规则意外匹配了/static/路径，导致静态资源请求被路由到视图而非Whitenoise处理。
• 确认STATIC_ROOT目录下已正确生成所有静态资源文件，且权限正常。

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