自定义Django用户模型与管理器后无法登录admin管理面板

常规排查项你已经全部完成，包括自定义用户模型配置、超级账号状态校验、认证后端配置、数据库同步操作，以下为代码层面存在的确定性问题与对应修复方式：

核心问题定位 #

• 手动覆盖了AbstractBaseUser父类自带的password字段，破坏了Django内置密码校验逻辑的字段绑定
• 自定义用户管理器的创建用户流程完全缺失密码哈希处理环节，存库的密码值无法通过内置登录校验

问题细节说明 #

1. 手动重写password字段的影响
   你在User模型中手动声明了password = models.CharField(max_length=255, blank=True, null=True)，该操作直接覆盖了父类自带的password核心字段。
   父类自带的password字段是Django密码加密、校验功能的核心绑定对象，配套了完整的哈希存储、明文对比逻辑。手动覆盖字段后，会导致内置的密码校验流程无法和实际存储的字段正常交互，最终校验失败。
2. 用户创建逻辑缺失密码处理流程
   你的自定义UserManager.create_user方法中，没有按照Django规范对传入的明文密码做加密处理：既没有调用set_password方法生成带盐的不可逆哈希值，也没有对空密码场景做保护，导致你通过createsuperuser创建账号时，输入的密码会以明文格式直接存库。
   Django登录校验时，会把数据库存储的密码值默认识别为符合格式的哈希串，明文值完全不满足格式要求，校验必然返回失败，无法完成登录。

修复步骤 #

• 删除User模型中手动声明的password字段，直接复用AbstractBaseUser父类内置的password字段即可，不需要手动重写。
• 修正UserManager.create_user方法的逻辑，补上标准密码处理流程，参考实现如下：

  def create_user(self, deviceId, password=None, **extra_fields):
      if not deviceId:
          raise ValueError('The device id must be set')
      extra_fields.setdefault('is_active', True)
      user = self.model(deviceId=deviceId, **extra_fields)
      # 对传入的明文密码做哈希处理
      if password:
          user.set_password(password)
      else:
          # 无密码场景设置不可登录状态，避免明文空密码存库
          user.set_unusable_password()
      user.save(using=self._db)
      return user
  

• 清空数据库中之前创建的管理员账号，重新执行python manage.py createsuperuser生成符合新密码逻辑的超级账号，再尝试登录admin即可。

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