Django自定义用户模型下超级用户创建成功却无法登录admin面板
问题根源排查
核心问题:形参大小写不匹配导致超级用户密码未正确设置
这也是你反复删除迁移文件、清空数据库重建依然无法解决问题的根本原因,属于代码层面的逻辑错误,和数据库、迁移流程无关。
- 你编写的
UserAccountManager里的create_user、create_superuser方法,形参将密码命名为大写开头的Password,但Django内置的createsuperuser命令在调用创建方法时,固定使用小写开头的password作为关键字参数传递用户输入的密码值。 - 大小写不匹配的情况下,用户在命令行输入的真实密码会被方法的
**other_fields可变参数字典捕获,不会赋值给形参Password,导致形参始终保持默认值None。 - 调用
user.set_password(None)时,Django会将用户密码设置为不可登录的无效哈希,不管在admin登录页输入什么密码,密码校验都会失败,直接触发你看到的错误提示。 - 因为整个流程没有抛出任何异常,所以终端会正常显示“超级用户创建成功”,但实际生成的用户根本无法通过密码校验。
其他遗留问题
- 手动重复定义
is_superuser字段:你自定义的Customer模型已经继承了PermissionsMixin,该混入类本身已经实现了is_superuser、权限关联等字段,手动重复定义同名字段会引发迁移文件冲突,属于冗余代码。 __str__方法逻辑漏洞:Name和Surname字段允许为空(null=True),直接做字符串拼接会在字段值为None时抛出TypeError,导致admin列表页、Shell操作时打印用户对象报错。- Admin配置缺失:你在
UserAdmin的权限配置字段里只加了is_superuser,没有把is_staff、is_active字段加进去,导致在admin后台无法查看/修改这两个控制登录权限的核心字段,排查问题时没有可视化参考。 - 缺少超级用户属性校验:创建超级用户时没有强制校验
is_staff、is_superuser、is_active三个属性的值,即使这三个值被意外设置为False,也能走完创建流程,生成无法登录admin的“超级用户”。
对应解决方法
修正Manager方法的形参命名
将UserAccountManager里的方法形参的密码字段改为小写password,匹配Django的传参规则:
- 把
create_user方法定义从def create_user(self, Email, Password = None, **other_fields):调整为def create_user(self, Email, password=None, **other_fields): - 把
create_superuser方法定义从def create_superuser(self, Email, Password = None, **other_fields):调整为def create_superuser(self, Email, password=None, **other_fields): - 同步把方法里调用
set_password的实参从大写Password改成小写password,即user.set_password(password)
完善Manager的超级用户校验逻辑
在create_superuser方法中增加强制校验,确保三个核心权限字段为True,避免生成无效的超级用户:
def create_superuser(self, Email, password=None, **other_fields): other_fields.setdefault('is_staff', True) other_fields.setdefault('is_superuser', True) other_fields.setdefault('is_active', True) # 增加强制校验 if other_fields.get('is_staff') is not True: raise ValueError('超级用户必须开启is_staff权限') if other_fields.get('is_superuser') is not True: raise ValueError('超级用户必须开启is_superuser权限') return self.create_user(Email=Email, password=password, **other_fields)
清理模型冗余代码
- 删除
Customer模型里手动定义的is_superuser = models.BooleanField(default=False)字段,直接复用父类PermissionsMixin提供的同名字段即可。 - 修正
__str__方法,避免字段为None时报错:
def __str__(self): full_name = f"{self.Name or ''} {self.Surname or ''}".strip() return full_name if full_name else self.Email
完善Admin配置
在UserAdmin的fieldsets和list_filter里补上缺失的权限字段,方便查看和修改用户权限:
fieldsets = ( (None, {'fields': ('Email', 'password')}), ('Personal info', {'fields': ('Birthday','Name','Surname')}), # 补上缺失的权限字段 ('Permissions', {'fields': ('is_active', 'is_staff', 'is_superuser', 'groups', 'user_permissions')}), )
内容的提问来源于stack exchange,提问作者Zeka Farzali
相关产品推荐
相关产品推荐

