Django allauth仅邮箱认证多用户注册触发UNIQUE约束错误

嘿，我来帮你搞定这个问题！

你遇到的这个错误，核心原因其实和你配置的allauth参数无关，问题出在Django默认的auth_user表上——它的username字段天生带有UNIQUE约束，哪怕你已经告诉allauth不需要用户名、只用邮箱登录，系统在创建新用户时还是会尝试给username字段赋值（通常是空字符串），而数据库里空字符串的唯一约束只能允许存在一条记录，第二次注册自然就触发报错了。

下面给你两种解决方案，按需选择：

方案一：自定义用户模型（最推荐，Django官方最佳实践） #

这是长期来看最稳妥的做法，尤其是项目还处于初期阶段时：

1. 在你的任意一个app的models.py里创建自定义用户模型，彻底移除username字段：

from django.contrib.auth.models import AbstractUser
from django.db import models

class CustomUser(AbstractUser):
    # 移除默认的username字段
    username = None
    # 将email设为唯一的认证字段
    email = models.EmailField(unique=True, verbose_name='邮箱')

    # 指定用邮箱作为登录标识
    USERNAME_FIELD = 'email'
    # 注册时不需要额外必填字段（除了email和密码）
    REQUIRED_FIELDS = []

2. 在项目的settings.py里指定使用这个自定义模型：

AUTH_USER_MODEL = '你的app名称.CustomUser'

3. 最后执行数据库迁移命令：

python manage.py makemigrations
python manage.py migrate

（如果是已有数据的老项目，建议先备份数据再操作，避免数据丢失）

方案二：让allauth自动生成唯一用户名（临时快速解决） #

如果暂时不想改动用户模型，可以让allauth自动为每个用户生成唯一的随机用户名，避免重复冲突。只需在settings.py里添加一行配置：

ACCOUNT_USERNAME_GENERATOR = 'django_allauth.utils.generate_unique_username'

这样系统会自动生成类似user12345这种唯一的用户名，既满足数据库的唯一约束，又不影响你只用邮箱注册登录的需求。

简单总结下：你之前的allauth配置没问题，但默认User模型的username字段约束没被处理，要么彻底去掉这个字段，要么让系统自动填充唯一值，就能解决重复注册的问题啦。

备注：内容来源于stack exchange，提问作者Nour Mohamed