使用Django AllAuth Gmail OAuth时，已注册邮箱登录跳转异常问题

问题原因 #

当使用已在APP注册过的邮箱通过Gmail OAuth登录时，AllAuth检测到该邮箱存在本地用户记录，但该用户未关联对应的Gmail社交账号，因此触发社交账号注册流程，跳转到/accounts/social/signup/页面。

解决方案 #

方案1：开启自动关联配置 #

在settings.py中添加/修改以下配置，让AllAuth自动将OAuth登录的邮箱与本地已有用户关联：

# 允许自动关联已有邮箱的用户
SOCIALACCOUNT_AUTO_SIGNUP = True
# 确保邮箱唯一性（默认已开启，可显式声明）
ACCOUNT_UNIQUE_EMAIL = True
# 如果用户邮箱已验证，可保持原设置；未验证时暂时关闭验证以跳过阻碍
ACCOUNT_EMAIL_VERIFICATION = 'none'

方案2：自定义社交账号适配器（灵活定制逻辑） #

如果需要更精细的控制，比如跳过额外字段校验或添加自定义关联逻辑，可自定义适配器：

1. 在你的应用目录下创建adapter.py文件：

from allauth.socialaccount.adapter import DefaultSocialAccountAdapter
from allauth.account.utils import perform_login
from django.contrib.auth import get_user_model

class CustomSocialAccountAdapter(DefaultSocialAccountAdapter):
    def pre_social_login(self, request, sociallogin):
        # 获取OAuth返回的用户邮箱
        user_email = sociallogin.account.extra_data.get('email')
        User = get_user_model()
        
        if user_email:
            try:
                # 查找本地数据库中该邮箱对应的用户
                existing_user = User.objects.get(email=user_email)
                # 关联社交账号与本地用户，跳过注册流程
                sociallogin.connect(request, existing_user)
                # 直接执行登录操作
                perform_login(request, existing_user, email_verification='optional')
            except User.DoesNotExist:
                # 无对应本地用户，走正常注册流程
                pass

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

SOCIALACCOUNT_ADAPTER = '你的应用名称.adapter.CustomSocialAccountAdapter'

方案3：确认用户模型兼容性 #

确保自定义MyUser模型与AllAuth配置完全匹配：

• 已设置USERNAME_FIELD = "email"
• settings.py中ACCOUNT_USER_MODEL_USERNAME_FIELD = None已配置
• 已执行python manage.py makemigrations和python manage.py migrate更新数据库结构

验证操作 #

1. 重启Django开发服务器
2. 使用已注册邮箱发起Gmail OAuth登录，验证是否直接跳转至首页
3. 检查数据库sociallaccount_socialaccount表，确认该用户已关联Gmail社交账号

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