如何避免使用Django allauth注册时出现duplicate key重复键错误

问题根本原因 #

你遇到的数据库唯一约束报错，核心是混用了Django自带django.contrib.auth的UserCreationForm和django-allauth的注册流程：

• allauth有自己的注册表单基类和整套校验、用户创建逻辑，你指定的注册表单继承自Django原生的用户创建表单，二者逻辑不兼容
• 原生UserCreationForm的校验逻辑没有和allauth的流程对齐，导致用户名唯一性校验没有生效，插入重复数据时直接触发数据库层面的约束报错
• 额外的代码错误：你现有表单中error_message = forms.UserCreationForm.error_messages.update(...)的写法是错误的，dict.update()方法返回None，后续抛出异常时会触发KeyError，属于潜在故障点

修复步骤 #

• 替换注册表单的继承基类
  不要使用Django原生的UserCreationForm作为自定义注册表单的父类，改用allauth自带的SignupForm基类，它已经内置了用户名、邮箱的唯一性校验逻辑，不需要你自己重复实现校验规则。
• 修正settings配置
  将ACCOUNT_SIGNUP_FORM_CLASS指向新的自定义注册表单路径即可。
• 移除重复的校验代码
  allauth开启用户名登录的配置下，默认会执行用户名唯一性校验，你自己写的clean_username属于冗余逻辑，可直接删除。
• 排查迁移状态
  确认自定义用户模型的所有修改都已经生成并执行了迁移，避免字段约束、序列同步问题引发的异常。

修正后的代码示例 #

forms.py 注册表单代码 #

from allauth.account.forms import SignupForm
from django import forms
from django.contrib.auth import get_user_model
from django.utils.translation import gettext_lazy as _

User = get_user_model()

# 原有Django admin使用的UserChangeForm不需要修改，可保留
class UserChangeForm(forms.UserChangeForm):
    class Meta(forms.UserChangeForm.Meta):
        model = User


class CustomSignupForm(SignupForm):
    # 可在此处添加你自定义用户模型中需要用户填写的注册字段
    name = forms.CharField(max_length=255, label=_("用户姓名"), required=False)
    title = forms.CharField(max_length=10, label=_("称谓"), required=False)

    def save(self, request):
        # 调用父类save方法完成allauth的默认用户创建逻辑
        user = super().save(request)
        # 保存自定义字段数据
        user.name = self.cleaned_data.get("name")
        user.title = self.cleaned_data.get("title")
        # 其他自定义字段赋值可在此处添加
        user.save()
        return user

settings.py 配置修改 #

将原有ACCOUNT_SIGNUP_FORM_CLASS改为：

ACCOUNT_SIGNUP_FORM_CLASS = 'users.forms.CustomSignupForm'

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