使用Django allauth多用户认证时省略username字段触发完整性错误

你遇到的UNIQUE constraint failed: accounts_user.username错误，核心原因是你使用了Django自带的UserCreationForm而非allauth的注册表单，导致allauth配置的ACCOUNT_USER_MODEL_USERNAME_FIELD = "email"逻辑未生效。保存用户时username字段默认被设为空字符串，多次注册就会因空值重复触发唯一约束冲突。

方案1：手动在表单save方法中填充username #

直接在你的注册表单save方法里，将username赋值为用户提交的email，避免空值重复：

# StudentSignUpForm的save方法修改
@transaction.atomic
def save(self):
    user = super().save(commit=False)
    email = self.cleaned_data.get('email')
    user.email = email
    # 手动将username设为email，规避唯一约束
    user.username = email
    user.is_student = True 
    user.save()
    student = Student.objects.create(user=user)
    return user

WriterSignUpForm的save方法做同样修改，添加user.username = self.cleaned_data.get('email')即可。

方案2：改用allauth的SignupForm继承 #

放弃UserCreationForm，转而继承allauth原生的SignupForm，让allauth的配置自动处理username映射：

from allauth.account.forms import SignupForm

class StudentSignUpForm(SignupForm):
    class Meta:
        model = get_user_model()
        fields = ("email",)
    
    @transaction.atomic
    def save(self, request):
        user = super().save(request)
        user.is_student = True
        user.save()
        Student.objects.create(user=user)
        return user

WriterSignUpForm同样修改继承类，添加自定义字段后，allauth会根据你的配置自动将email赋值给username字段。

方案3：修改User模型的username约束（可选） #

如果你的自定义User模型不需要username字段的唯一约束，可以直接调整模型定义：

from django.contrib.auth.models import AbstractUser

class User(AbstractUser):
    # 取消username的唯一约束，允许为空
    username = models.CharField(max_length=150, unique=False, blank=True, null=True)
    # 确保email唯一（保留原有逻辑）
    email = models.EmailField(unique=True)

修改后执行python manage.py makemigrations和python manage.py migrate更新数据库。

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