生产模式下Django Admin登录后无法加载管理页面问题

问题表现：生产环境UWSGI+NGINX架构下，admin登录提交账号密码后返回200状态码，停留在登录页，提示「请输入正确的员工账号邮箱地址和密码，请注意两个字段均区分大小写」，重置密码后问题依旧。

高频问题排查（按优先级从高到低） #

1. 确认UWSGI加载的环境与你操作的环境一致 #

这是生产部署最容易踩的坑，90%的类似问题都是环境不匹配导致：

• 登录服务器，进入你认为的项目根目录，执行python manage.py shell，运行以下代码校验超级用户状态：

from api.models import CustomUser
# 替换成你登录用的邮箱和密码
user = CustomUser.objects.get(email="your_admin_email@example.com")
print("用户状态：", user.is_active, user.is_staff, user.is_superuser)
print("密码校验结果：", user.check_password("your_login_password"))

• 如果输出不是三个True加密码校验返回True，说明你之前改密码、创建超级用户的操作，没有落到UWSGI实际连接的数据库上：
  • 打开UWSGI配置文件，检查chdir参数是否指向你当前执行shell命令的项目根目录，工作目录错误会导致UWSGI读取旧的配置、连接旧的数据库
  • 检查项目根目录下生产环境用的.env文件，确认数据库配置和你shell环境读取的一致，避免UWSGI连了测试库或空库
  • 注意：修改任何配置、代码后必须重启UWSGI进程，否则改动不会生效

2. 修复自定义邮箱认证后端的逻辑缺陷 #

你当前配置的AUTHENTICATION_BACKENDS仅保留了自定义的api.backends.EmailBackend，没有保留Django默认的认证后端，只要自定义后端逻辑有问题，就会直接导致认证失败：

• 打开api/backends.py检查EmailBackend的authenticate方法，重点排查以下问题：
  • 邮箱查询是否做了大小写兼容：直接用email=username查询会导致用户输入大写邮箱时查不到用户，要改成email__iexact=username做不区分大小写的匹配
  • 是否过滤了非激活用户：必须添加is_active=True的查询条件，非激活用户不允许登录
  • 密码校验是否用了Django内置的user.check_password(password)方法，不要自己实现哈希比对逻辑
  • 不要在认证后端里额外加is_staff、is_superuser的拦截判断，admin的权限校验是登录流程自己处理的，写在认证后端里容易造成误拦截
• 临时验证可以先把Django默认的ModelBackend加回配置，快速定位是不是自定义后端的问题：

AUTHENTICATION_BACKENDS = [
    'api.backends.EmailBackend',
    'django.contrib.auth.backends.ModelBackend'
]

3. 排查NGINX与Session配置问题 #

• 检查NGINX的UWSGI转发配置，确认没有遗漏必要请求头的传递，尤其是Host头，头信息传递错误会导致CSRF校验、Session写入异常
• 检查settings中的Session相关配置：如果设置了SESSION_COOKIE_SECURE=True，必须用HTTPS协议访问admin，否则Session无法写入浏览器，登录状态无法保存；如果配置了SESSION_COOKIE_DOMAIN，要确保值和你访问admin的域名完全匹配

次频问题排查 #

• 检查超级用户权限：如果超级用户的is_staff字段被误设为False，就算密码正确也无法登录admin，会直接返回账号密码错误的提示
• 检查目录权限：确保UWSGI运行用户对项目根目录、Session存储目录（如果用文件引擎存储Session）有读写权限，权限不足会导致Session无法写入，登录状态丢失
• 检查权限插件配置：你用了django-guardian权限插件，确认没有配置全局匿名用户拦截规则，误拦截超级用户的正常访问

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