django-rest-auth Facebook社交登录因已有邮箱触发唯一约束冲突

看起来你遇到的问题核心在于：当使用已绑定到本地账号的邮箱通过Facebook登录时，Web端的allauth会自动引导用户补全或关联账号，但rest-auth的API没有处理这种冲突场景，直接尝试创建新用户，而由于ACCOUNT_USERNAME_REQUIRED=False，生成的空username触发了数据库唯一约束错误。

问题根源分析 #

默认情况下，Django的auth_user表中username字段是唯一且非空的。当你设置ACCOUNT_USERNAME_REQUIRED=False后，allauth在自动注册社交用户时会尝试用空字符串作为username，但如果已有用户的username是空的，新用户创建就会触发duplicate key错误。Web端的allauth会捕获这种冲突并跳转注册表单，而rest-auth的API流程没有这个容错处理，直接抛出异常。

解决方案 #

方案1：自定义SocialAccountAdapter，关联已有用户

通过重写allauth的适配器，在社交登录前检查邮箱是否已存在本地用户，如果存在就直接关联该用户，而不是创建新用户。

1. 在你的Django app中创建adapter.py文件：

from allauth.socialaccount.adapter import DefaultSocialAccountAdapter
from django.contrib.auth.models import User
from allauth.exceptions import ImmediateHttpResponse
from django.http import JsonResponse

class CustomSocialAccountAdapter(DefaultSocialAccountAdapter):
    def pre_social_login(self, request, sociallogin):
        # 从Facebook返回的信息中获取邮箱
        email = sociallogin.account.extra_data.get('email')
        if email:
            try:
                # 查找已存在的本地用户
                existing_user = User.objects.get(email=email)
                # 关联社交账号到现有用户
                sociallogin.connect(request, existing_user)
                # 返回成功响应，终止自动注册流程
                raise ImmediateHttpResponse(
                    JsonResponse({"detail": "Account linked successfully"}, status=200)
                )
            except User.DoesNotExist:
                # 没有找到用户，继续自动注册流程
                pass
        return super().pre_social_login(request, sociallogin)

2. 在settings.py中配置自定义适配器：

SOCIALACCOUNT_ADAPTER = 'your_app_name.adapter.CustomSocialAccountAdapter'

方案2：生成唯一的username（避免空值冲突）

既然Django要求username唯一，我们可以让allauth自动生成唯一的username，即使不需要用户输入。

1. 在app中创建utils.py文件，编写生成唯一username的函数：

import uuid
from django.utils.text import slugify

def generate_unique_username(email):
    # 用邮箱前缀+随机字符串生成唯一username
    email_prefix = slugify(email.split('@')[0])
    random_suffix = uuid.uuid4().hex[:8]
    return f"{email_prefix}_{random_suffix}"

2. 在settings.py中配置username生成器：

ACCOUNT_USERNAME_GENERATOR = 'your_app_name.utils.generate_unique_username'

为什么Web端正常？ #

Web端的allauth内置了冲突处理逻辑：当自动注册遇到唯一约束错误时，会自动跳转到注册页面，让用户手动完成账号关联或补全信息。而rest-auth的API流程没有处理这种异常，直接将数据库错误抛给客户端，所以需要我们自定义逻辑来处理。

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