Wagtail后台登录无限循环问题排查请求（EKS部署Docker化应用）

你的环境：Docker化部署在EKS集群的Wagtail（2.5.1）+ Django（2.1.x~2.2.x）应用，前端功能正常，但访问domain.com/admin登录时陷入无限重定向循环。

以下是针对性排查步骤：

1. Django核心配置检查 #

• ALLOWED_HOSTS：确认配置包含你的域名domain.com，EKS环境下需额外加入集群内部服务域名或负载均衡IP，避免因主机头不被信任触发重定向。
• CSRF_TRUSTED_ORIGINS：Django 2.1+需将https://domain.com加入该列表，否则CSRF验证失败会引发重定向。
• SECURE_SSL_REDIRECT：若开启该参数，需确保Django能识别真实请求协议——EKS负载均衡常将HTTPS转成HTTP传递给容器，此时需配置SECURE_PROXY_SSL_HEADER = ('HTTP_X_FORWARDED_PROTO', 'https')，否则会在HTTP/HTTPS间循环重定向。

2. Wagtail路由与中间件检查 #

• 确认urls.py正确引入Wagtail admin路由：

  from wagtail.admin import urls as wagtailadmin_urls
  urlpatterns = [
      # 其他业务路由
      path('admin/', include(wagtailadmin_urls)),
  ]
  

• 检查中间件顺序，确保django.contrib.sessions.middleware.SessionMiddleware和django.contrib.auth.middleware.AuthenticationMiddleware处于中间件列表靠前位置，排查自定义中间件是否干扰登录流程。

3. 依赖版本兼容性排查 #

Wagtail 2.5.1与Django 2.1.x~2.2.x官方兼容，但需关注第三方依赖的潜在问题：

• wagtailmenus==3.1.2：确认该版本与Wagtail 2.5.1兼容，部分第三方菜单插件可能修改admin路由或会话逻辑，可临时移除该包测试是否解决问题。
• django-csp：内容安全策略配置不当会阻止admin页面必要资源加载，间接导致登录异常，可临时关闭CSP验证。

4. EKS/Docker部署层面检查 #

• 容器环境变量：确认DEBUG设为False（生产环境），同时检查SECRET_KEY配置是否正确；若DEBUG=True但域名不在ALLOWED_HOSTS也会引发重定向。
• 负载均衡配置：EKS的ALB/NLB需正确传递X-Forwarded-Proto和X-Forwarded-Host请求头，Django依赖这些头识别外部请求的真实协议与域名，否则会生成错误的重定向URL。
• 会话存储：若使用数据库存储会话（默认），确认数据库连接正常；若用Redis等外部存储，检查连接配置是否正确——会话无法写入会导致登录状态无法保持，触发重定向。

5. 日志排查 #

• 查看Django应用日志，搜索redirect、CSRF相关错误，比如CSRF cookie not set或Invalid HTTP_HOST header，这类日志会直接指向问题根源。
• 查看uWSGI日志，确认请求是否正常到达应用，以及请求头是否完整传递。

若以上步骤无法解决，需补充以下信息：

• Django settings.py中ALLOWED_HOSTS、SECURE_*、CSRF_*相关配置片段
• EKS负载均衡的路由规则配置
• 应用容器的启动命令或uWSGI配置

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