Django DRF自定义用户模型API创建用户时报email唯一约束错误
报错排查与修复
直接触发IntegrityError的核心bug
问题出在自定义用户管理器的create_user方法中:
原代码里创建用户实例的行存在逻辑错误:
# 错误写法 user = self.model(username=username,email=self.normalize_email)
- 问题本质:这里没有执行
normalize_email方法对传入的email参数做格式校验处理,直接把未调用的方法对象本身作为值赋值给了email字段。这意味着无论接口前端传入什么邮箱地址,最终写入数据库的email值都是这个方法对象对应的固定字符串,第一次创建用户时可以正常写入,第二次提交请求时,由于email字段值和第一次完全一致,自然触发数据库的唯一约束报错。 - 修正写法:将传入的email作为参数传给
normalize_email方法处理,确保每个用户的email值是前端传入的真实邮箱:
user = self.model(username=username, email=self.normalize_email(email))
需同步补全的缺失逻辑(避免后续连锁报错)
- 自定义用户模型缺少后台与权限校验依赖的基础字段:当前的User模型只定义了username、email字段,没有包含权限校验依赖的
is_active、is_staff字段,后续登录校验、后台权限判断会直接抛出字段不存在的错误,需要在User类中补充:is_active = models.BooleanField(default=True) is_staff = models.BooleanField(default=False) create_superuser方法的权限标记缺失:当前方法没有给创建的超级用户配置对应的权限位,生成的超级用户无法登录Django后台,需要补充赋值逻辑:def create_superuser(self, username, email, password=None): if password is None: raise TypeError('Password should not be none') user = self.create_user(username, email, password) # 补全超级用户的权限标记 user.is_superuser = True user.is_staff = True user.save() return user
修复后的验证流程
- 修正所有代码bug后,如果是项目初始化阶段的自定义用户模型,可删除旧的迁移文件、清空数据库中对应app的旧表结构,重新执行
makemigrations生成迁移记录、执行migrate重建表结构 - 重新调用注册接口提交不同的邮箱地址,即可正常完成用户创建,不会再触发唯一约束冲突。
内容的提问来源于stack exchange,提问作者Gaurav Kumar
相关产品推荐
相关产品推荐

