删除Django forms.ModelForm中username字段为何注册失败？如何修复？

这个问题的核心原因很明确：Django自带的User模型要求username字段是必填且唯一的。你删除表单里的username字段后，创建用户实例时没有给这个字段赋值，要么会被设为空字符串（但空字符串只能有一个，重复注册就会触发唯一约束错误），要么直接缺失值导致报错。

下面给你两种可行的修复方案，根据你的项目阶段选择：

方案一：快速修复——自动生成唯一的username（适合现有项目） #

不需要修改默认的User模型，只需要在表单的save()方法里自动生成一个唯一的username值即可。这样既满足Django对User模型的要求，又能让前端只收集邮箱和密码。

修改你的forms.py：

from django import forms
from django.contrib.auth.models import User
from .models import UserProfileInfo
import uuid  # 用来生成唯一ID，可选

class UserForm(forms.ModelForm):
    email = forms.EmailField(required=True)
    password = forms.CharField(widget=forms.PasswordInput())

    class Meta():
        model = User
        # 只保留邮箱和密码字段，不需要username
        fields = ('email', 'password')

    def save(self, commit=True):
        # 先不提交到数据库
        user = super().save(commit=False)
        
        # 生成唯一的username，这里提供两种方式：
        # 方式1：从邮箱提取前缀，重复则加数字后缀
        username_base = self.cleaned_data['email'].split('@')[0][:27]  # 留3位给数字后缀
        username = username_base
        counter = 1
        while User.objects.filter(username=username).exists():
            username = f"{username_base}{counter}"
            counter += 1
        
        # 方式2：直接用UUID（更简单，绝对唯一）
        # username = str(uuid.uuid4())[:30]  # Django的username最长30字符
        
        # 给user对象赋值username和email
        user.username = username
        user.email = self.cleaned_data['email']
        
        if commit:
            user.save()
            # 如果需要关联UserProfileInfo，在这里处理
            UserProfileInfo.objects.create(user=user)
        return user

这样用户注册时，后台会自动生成一个唯一的username，完全不需要前端输入，也就不会触发唯一约束错误了。

方案二：长期最优解——自定义用户模型（适合新项目或可重构的项目） #

如果你的项目还处于初期，或者可以接受重构用户模型，强烈推荐自定义一个以邮箱作为唯一标识的用户模型，从根源上摆脱对username的依赖。

步骤1：创建自定义用户模型（models.py） #

from django.contrib.auth.models import AbstractBaseUser, BaseUserManager, PermissionsMixin
from django.db import models

# 自定义用户管理器
class CustomUserManager(BaseUserManager):
    def create_user(self, email, password=None, **extra_fields):
        if not email:
            raise ValueError("用户必须提供邮箱地址")
        # 标准化邮箱格式（比如转小写）
        email = self.normalize_email(email)
        user = self.model(email=email, **extra_fields)
        user.set_password(password)
        user.save(using=self._db)
        return user

    def create_superuser(self, email, password=None, **extra_fields):
        # 超级用户需要staff和superuser权限
        extra_fields.setdefault('is_staff', True)
        extra_fields.setdefault('is_superuser', True)
        return self.create_user(email, password, **extra_fields)

# 自定义用户模型
class CustomUser(AbstractBaseUser, PermissionsMixin):
    email = models.EmailField(unique=True, max_length=255, verbose_name="邮箱")
    is_active = models.BooleanField(default=True, verbose_name="是否激活")
    is_staff = models.BooleanField(default=False, verbose_name="是否为管理员")
    
    # 关联自定义管理器
    objects = CustomUserManager()

    # 指定用邮箱作为登录的唯一标识
    USERNAME_FIELD = 'email'
    # 不需要其他必填字段（如果需要可以添加，比如姓名）
    REQUIRED_FIELDS = []

    def __str__(self):
        return self.email

步骤2：配置settings.py #

在项目的settings.py里添加一行，指定使用自定义用户模型：

AUTH_USER_MODEL = 'your_app_name.CustomUser'  # 替换成你的app名称，比如'myapp.CustomUser'

步骤3：修改表单（forms.py） #

使用自定义用户模型创建注册表单：

from django import forms
from django.contrib.auth.forms import UserCreationForm
from .models import CustomUser

class UserForm(UserCreationForm):
    class Meta:
        model = CustomUser
        # 只需要邮箱和密码字段
        fields = ('email', 'password1', 'password2')

注意事项 #

• 自定义用户模型最好在项目初始化时就设置，如果你已经有数据库迁移记录，需要清空数据库并重新生成迁移（或者手动处理迁移数据，这对新手来说比较复杂）。
• 之后所有涉及用户的操作，都要使用get_user_model()来获取用户模型，而不是直接导入django.contrib.auth.models.User。

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