Django-allauth微软社交账号无法自动关联已有本地用户求助

问题背景 #

站点基于Django-allauth 65.7.0构建，存在大量遗留本地用户，要求用户通过微软Graph登录时，若邮箱与本地用户匹配，自动关联社交账号到该本地用户（所有微软邮箱视为已验证，无需额外验证）。当前现象：未注册邮箱的微软账号可正常创建新用户及社交账号；已注册邮箱的微软账号登录成功，但未关联对应的社交账号。

当前配置 #

ACCOUNT_LOGIN_METHODS = {"email"}
ACCOUNT_USER_MODEL_USERNAME_FIELD = None
SOCIALACCOUNT_PROVIDERS = {
    "microsoft": {
        "EMAIL_AUTHENTICATION_AUTO_CONNECT": True,
        "EMAIL_AUTHENTICATION": True,
        "EMAIL_VERIFICATION": False,
        "VERIFIED_EMAIL": True,
        "APPS": [
            # client id, secret masked
        ]
    }
}

解决方案 #

1. 补充关键配置项 #

首先检查并补充以下配置，确保allauth优先通过邮箱匹配用户：

# settings.py
ACCOUNT_EMAIL_REQUIRED = True  # 强制邮箱为用户必填字段，触发邮箱匹配逻辑
SOCIALACCOUNT_LINKACCOUNTS_ENABLED = True  # 允许关联社交账号到本地用户（默认已开启，若被修改需恢复）
ACCOUNT_PRESERVE_USERNAME_CASING = False  # 忽略邮箱大小写差异，避免匹配失败

ACCOUNT_EMAIL_REQUIRED是核心前提：只有当邮箱被设为必填项时，EMAIL_AUTHENTICATION_AUTO_CONNECT才能正常触发同邮箱用户的自动关联逻辑。

2. 验证邮箱一致性 #

确认本地用户的邮箱与微软Graph返回的邮箱完全匹配（包括无多余空格、大小写统一）。若数据库中邮箱存在大小写不一致的情况，可批量更新本地用户邮箱为小写：

# 在Django shell中执行
from django.contrib.auth import get_user_model
User = get_user_model()
for user in User.objects.all():
    if user.email:
        user.email = user.email.lower()
        user.save()

3. 简化自定义适配器（若配置调整无效） #

如果上述配置仍未解决问题，可通过极简的自定义适配器实现自动关联，无需复杂逻辑：

# 在你的app下创建adapter.py
from allauth.socialaccount.adapter import DefaultSocialAccountAdapter
from django.contrib.auth import get_user_model

class CustomSocialAccountAdapter(DefaultSocialAccountAdapter):
    def pre_social_login(self, request, sociallogin):
        user = sociallogin.user
        if user.email:
            try:
                existing_user = get_user_model().objects.get(email__iexact=user.email)
                # 关联社交账号到已存在的本地用户
                sociallogin.connect(request, existing_user)
            except get_user_model().DoesNotExist:
                pass

然后在settings中指定适配器：

SOCIALACCOUNT_ADAPTER = 'your_app_name.adapter.CustomSocialAccountAdapter'

这个钩子会在社交登录完成前触发，自动匹配同邮箱的本地用户并完成关联。

内容的提问来源于stack exchange，提问作者J. Couch