Django自定义用户模型创建超级用户时的TypeError与字段冲突问题
问题根因排查
两次报错的对应原因
- 第一次运行
createsuperuser报unexpected keyword argument 'is_staff':自定义用户模型虽然继承了权限相关的基类,但缺少Django用户体系必需的基础权限字段,AccountManager在创建用户时传入的is_staff参数没有对应模型字段承接,触发类型错误。 - 第二次调整代码后报
models.E006字段冲突:手动在自定义模型中重复定义了is_superuser字段,该字段是父类PermissionsMixin内置提供的,同名字段重复定义触发模型校验错误。
修复步骤
- 补全模型缺失的权限字段,避免重复定义父类已有的字段
修正后的完整模型代码如下:from django.db import models from django.contrib.auth.base_user import BaseUserManager from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin from django.utils.translation import gettext_lazy as _ class AccountManager(BaseUserManager): 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 extra_fields.get('is_staff') is not True: raise ValueError(_('Superuser must have is_staff=True.')) if extra_fields.get('is_superuser') is not True: raise ValueError(_('Superuser must have is_superuser=True.')) return self.create_user(email, password, **extra_fields) def create_user(self, email, password, **extra_fields): extra_fields.setdefault('is_staff', False) extra_fields.setdefault('is_superuser', False) if not email: raise ValueError(_('Enter the email before proceeding')) email = self.normalize_email(email) user = self.model(email=email, password=password, **extra_fields) user.set_password(password) user.save() return user class NewEmployeeProfile(AbstractBaseUser, PermissionsMixin): email = models.EmailField(unique=True) first_name = models.CharField(max_length=100) last_name = models.CharField(max_length=100) employee_code = models.IntegerField() contact = models.CharField(max_length=10) # 补充缺失的两个基础权限字段 is_staff = models.BooleanField(default=False) is_active = models.BooleanField(default=True) objects = AccountManager() USERNAME_FIELD = 'email' REQUIRED_FIELDS = ['first_name', 'last_name', 'contact'] def __str__(self): return str(self.email)这里需要明确两个父类的字段边界,避免踩坑:
AbstractBaseUser仅提供密码加密存储、会话校验的基础能力,不内置任何身份状态字段PermissionsMixin仅内置is_superuser字段、用户权限组、用户单权限的关联关系,不提供is_staff、is_active字段
所以自定义用户模型必须显式补充is_staff、is_active两个字段,不要重复声明父类已经提供的is_superuser,否则就会同时触发你遇到的两类报错。
- 执行迁移流程
因为是在已有迁移记录的基础上新增字段,重新运行makemigrations时,Django会提示为新增的非空字段设置默认值,选择为现有记录应用is_staff=False、is_active=True的默认值即可,不会破坏原有数据。
依次执行命令:python manage.py makemigrationspython manage.py migrate
- 校验配置项
确认项目settings.py中已正确指向自定义用户模型,否则Django会默认使用内置User模型,触发连锁报错:AUTH_USER_MODEL = 'AUTHENTICATION.NewEmployeeProfile' - 重新执行
createsuperuser命令,即可正常按流程输入邮箱、姓名、联系方式创建超级用户。
内容的提问来源于stack exchange,提问作者user3521180
相关产品推荐
相关产品推荐

