Django执行createsuperuser创建超级用户后无法登录Admin后台问题

核心根因 #

你当前自定义的Account模型所有权限类字段默认值均为False，在自定义用户模型替换Django默认用户体系的场景下，非常容易出现命令行创建超级用户时，权限字段没有被正确写入数据库的问题。而Django Admin出于安全设计，不会区分是密码错误、账号被禁用、权限不足，所有认证失败的场景都会统一弹出相同的“邮箱密码错误”提示，很容易误导排查方向。 #

具体排查与操作步骤 #

• 第一步：核对数据库中已创建超级用户的实际字段值
  进入Django Shell执行以下代码，替换成你实际创建的用户邮箱：

  from django.contrib.auth import get_user_model
  User = get_user_model()
  # 替换为你创建超级用户时填写的邮箱
  current_user = User.objects.get(email="your_admin_email@example.com")
  # 输出所有关键权限字段的状态、密码校验结果
  print(
      "账号激活状态:", current_user.is_active,
      "后台访问权限:", current_user.is_staff,
      "超级管理员权限:", current_user.is_superuser,
      "密码校验结果:", current_user.check_password("你登录时输入的密码")
  )
  

  以上任意一项输出为False，都会直接导致登录被拦截。尤其是is_active默认值为False时，哪怕你通过createsuperuser命令走完了创建流程，只要该字段没有被手动设为True，认证环节会直接判定为无效凭据。
• 第二步：校验自定义用户管理器的create_superuser实现
  绝大多数人替换默认用户模型时，会遗漏在create_superuser方法里强制写入权限字段的逻辑，因为模型本身的权限字段默认是False，最终创建出来的“超级用户”完全没有对应权限。
  合规的create_superuser方法必须包含以下强制赋值逻辑：

  def create_superuser(self, email, password, **extra_fields):
      # 强制为超级用户配置必要的权限位
      extra_fields.setdefault("is_staff", True)
      extra_fields.setdefault("is_superuser", True)
      extra_fields.setdefault("is_active", True)
      # 增加权限位校验，避免生成无权限的异常超级用户
      if not extra_fields.get("is_staff"):
          raise ValueError("超级用户必须设置 is_staff = True")
      if not extra_fields.get("is_superuser"):
          raise ValueError("超级用户必须设置 is_superuser = True")
      return self._create_user(email, password, **extra_fields)
  

• 第三步：快速修复异常的已创建账号
  如果确认是之前创建的用户字段值不对，不需要重新走createsuperuser流程，直接在Shell中修正即可：

  current_user = User.objects.get(email="your_admin_email@example.com")
  # 手动修正所有必要权限位
  current_user.is_active = True
  current_user.is_staff = True
  current_user.is_superuser = True
  # 重新设置一次密码，避免密码哈希不匹配的问题
  current_user.set_password("你要使用的登录密码")
  current_user.save()
  

• 第四步：排查容易遗漏的隐性拦截点
  • 核对settings.py中的AUTH_USER_MODEL配置，确保指向的是你当前使用的Account模型，避免出现创建用户写入的数据库表和Admin后台读取的用户表不一致的问题
  • 注意邮箱的大小写匹配规则：你提到登录提示中特意说明字段区分大小写，Django默认的认证逻辑会将邮箱作为普通字符串做等值匹配，如果创建账号时使用的是大写开头的邮箱，登录时输全小写的同内容邮箱会直接匹配失败
  • 检查你自定义的认证后端逻辑：你的Account模型包含is_admin字段，如果自定义认证流程中额外增加了is_admin=True的校验条件，哪怕其他权限字段全部正确，只要这个字段为默认的False，就会被拦截并返回通用的凭据错误提示

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