Django创建超级用户提示已存在但数据库为空的问题求助

一、创建超级用户时邮箱重复的IntegrityError问题 #

可能原因及解决办法： #

• PostgreSQL大小写特性影响：PostgreSQL默认对字符串类型的唯一性约束区分大小写，若自定义User模型中邮箱字段设了unique=True，但迁移时可能因残留约束或数据导致异常。先确认数据库是否真的为空——用PgAdmin4直接查询用户表，排查是否有隐藏的残留数据。
• 迁移记录残留：哪怕数据库看起来是空的，之前的迁移操作可能留下无效约束。可以：
  1. 备份数据库后清空，重新执行python manage.py makemigrations和python manage.py migrate。
  2. 检查迁移文件里邮箱字段的约束定义，确保unique=True的配置正确生成。
• UserManager的create_superuser方法存在bug：检查你的create_superuser实现，是否有重复调用save()的逻辑，比如：

  def create_superuser(self, email, password=None, **extra_fields):
      user = self.create_user(email, password, **extra_fields)
      user.is_superuser = True
      user.save()
      user.save()  # 重复保存会触发重复字段异常
      return user
  

  修正为只调用一次save()即可。

二、登录后台的大小写敏感错误 #

你自定义了CaseSensitiveModelBackend但出现大小写问题，大概率是认证逻辑不符合预期：

• 调整authenticate方法的查询逻辑：如果需要邮箱登录不区分大小写，查询时将输入的邮箱转为统一格式（比如小写），用不区分大小写的条件匹配：

  class CaseSensitiveModelBackend(ModelBackend):
      def authenticate(self, request, username=None, password=None, **kwargs):
          # 这里的username实际是登录时输入的邮箱
          try:
              user = User.objects.get(email__iexact=username.lower())
          except User.DoesNotExist:
              return None
          if user.check_password(password):
              return user
  

  要是你确实需要严格区分大小写，那要确保创建用户时的邮箱大小写和登录输入完全一致，同时数据库的邮箱字段约束保持默认的区分大小写特性。
• 确认AUTH_USER_MODEL配置：在settings.py里必须正确指定自定义用户模型：

  AUTH_USER_MODEL = 'yourapp.Users'
  

• 适配后台登录字段：Django默认后台用username登录，若你用邮箱作为登录标识，必须在Users模型里设置：

  class Users(AbstractBaseUser):
      email = models.EmailField(unique=True)
      USERNAME_FIELD = 'email'  # 指定邮箱作为登录字段
      REQUIRED_FIELDS = []  # 根据需求添加其他必填字段
      objects = UserManager()
  

额外排查步骤 #

• 用PgAdmin4直接查询用户表，确认是否存在重复邮箱数据。
• 运行python manage.py shell，手动创建超级用户测试，排查是命令行工具的问题还是模型/管理器的逻辑问题：

  from yourapp.models import Users
  user = Users.objects.create_superuser(email='test@example.com', password='test123')
  

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