Django扩展用户模型遇约束错误及字段校验需求咨询

咱们先从你遇到的第一个错误说起，再一步步解决你后续的两个需求。

一、最初的IntegrityError错误原因分析 #

你遇到的NOT NULL constraint failed: hire_teacher.email错误，根源在于模型设计和使用方式的几个问题：

1. 错误使用多表继承
   你让Teacher和Student直接继承自具体的User模型（User继承自AbstractUser且未设置abstract=True），这属于Django的多表继承。这种方式会为每个子类创建独立的数据表，子类表仅包含自身定义的字段，通过外键关联父类User表。但错误提示hire_teacher.email字段非空约束失败，说明你的hire_teacher表中意外存在email字段——这大概率是之前的迁移操作遗留的表结构冲突，或者模型定义逻辑混乱导致的。

2. 错误设置用户类型字段
   你在Teacher和Student类中写的is_teacher = True、is_student = True只是普通类属性，并非Django模型字段，不会被同步到数据库，也无法真正标记用户类型。

3. 拼写错误导致配置失效
   你把REQUIRED_FIELDS写成了REQUIRED_FIELD（少了复数后缀），这会让Django无法识别必填字段配置，进而影响字段初始化逻辑。

4. 未使用正确的用户创建方法
   创建Django用户必须用UserManager提供的create_user方法，而非直接实例化后调用save()。create_user会自动处理密码哈希、字段默认值等关键逻辑，直接save()很容易导致字段初始化不完整。

二、修复模型设计的推荐方案 #

针对你的场景，推荐两种更合理的用户扩展方式：

方案1：代理模型（适合仅区分用户类型、不需要大量额外字段的场景） #

代理模型共用父类User的表，仅添加自定义逻辑，不会生成新表：

from django.contrib.auth.models import AbstractUser, BaseUserManager
from django.db import models
from django.core.exceptions import ValidationError

class User(AbstractUser):
    is_student = models.BooleanField(default=False)
    is_teacher = models.BooleanField(default=False)
    # 给Student添加reg_num字段（因为代理模型共用父表，所以字段要放在父类）
    reg_num = models.CharField(max_length=45, blank=True, null=True)

class TeacherManager(BaseUserManager):
    def get_queryset(self):
        return super().get_queryset().filter(is_teacher=True)
    
    def create_user(self, username, email=None, password=None, **extra_fields):
        if not password:
            raise ValueError("密码不能为空")
        extra_fields.setdefault('is_teacher', True)
        return super().create_user(username, email, password, **extra_fields)

class Teacher(User):
    objects = TeacherManager()
    
    class Meta:
        proxy = True

class StudentManager(BaseUserManager):
    def get_queryset(self):
        return super().get_queryset().filter(is_student=True)
    
    def create_user(self, username, email=None, password=None, reg_num=None, **extra_fields):
        if not password:
            raise ValueError("密码不能为空")
        if not reg_num:
            raise ValueError("学生必须填写学号")
        extra_fields.setdefault('is_student', True)
        user = super().create_user(username, email, password, **extra_fields)
        user.reg_num = reg_num
        user.save()
        return user

class Student(User):
    objects = StudentManager()
    
    class Meta:
        proxy = True
    
    def clean(self):
        super().clean()
        # 保存前校验学号（覆盖场景也生效）
        if self.is_student and not self.reg_num:
            raise ValidationError("学生学号不能为空")
        if not self.password:
            raise ValidationError("密码不能为空")
    
    def save(self, *args, **kwargs):
        self.full_clean()  # 触发校验
        super().save(*args, **kwargs)

创建用户的正确方式：

from hire.models import Teacher, Student
# 创建教师
teacher = Teacher.objects.create_user(username='teacherAubrey', email='learn@aubrey.com', password='squarerootof69is8sum')
# 创建学生
student = Student.objects.create_user(username='studentJohn', email='john@example.com', password='test123', reg_num='S12345')

方案2：一对一Profile模型（适合需要大量额外字段的场景） #

如果两类用户的额外字段差异很大，可以用一对一关联的Profile模型扩展：

from django.contrib.auth.models import AbstractUser
from django.db import models
from django.core.exceptions import ValidationError
from django.db.models.signals import post_save
from django.dispatch import receiver

class User(AbstractUser):
    is_student = models.BooleanField(default=False)
    is_teacher = models.BooleanField(default=False)

class TeacherProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE, primary_key=True)
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

class StudentProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE, primary_key=True)
    reg_num = models.CharField(max_length=45, blank=False)  # 数据库层面非空约束
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)
    
    def clean(self):
        super().clean()
        if not self.reg_num:
            raise ValidationError("学生学号不能为空")

# 信号自动创建Profile
@receiver(post_save, sender=User)
def create_user_profile(sender, instance, created, **kwargs):
    if created:
        if instance.is_teacher:
            TeacherProfile.objects.create(user=instance)
        elif instance.is_student:
            # 创建学生时必须先设置reg_num，这里可以加校验
            if not hasattr(instance, 'reg_num') or not instance.reg_num:
                raise ValueError("学生必须填写学号")
            StudentProfile.objects.create(user=instance, reg_num=instance.reg_num)

三、你的两个需求实现 #

上面的方案已经内置了需求的实现逻辑，再单独拆解说明：

1. Student的reg_num为空时无法保存

   • 代理模型：通过重写clean()方法在校验阶段抛出错误，同时在StudentManager的create_user方法中提前拦截无学号的创建请求。
   • Profile模型：给StudentProfile的reg_num设置blank=False（数据库层面约束），同时重写clean()方法做业务校验。

2. 两类用户未提供密码时无法保存

   • 在自定义管理器的create_user方法中添加密码非空校验，阻止无密码的用户创建；
   • 重写模型clean()方法，确保修改用户时密码也不会被清空。

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