django-allauth Twitter社交登录无法获取邮箱触发KeyError求助

我之前也踩过这个Twitter登录拿不到邮箱的坑！其实光设置SOCIALACCOUNT_QUERY_EMAIL = True远远不够，结合Twitter的API权限规则和django-allauth的具体配置，咱们一步步来搞定：

1. 先搞定Twitter开发者平台的权限配置 #

Twitter默认不会向第三方应用返回用户邮箱，必须先在开发者后台开启对应权限：

• 登录Twitter Developer Portal，进入你的项目
• 左侧菜单选择Permissions and features，找到Email addresses权限，点击"Apply"提交申请（审核通常很快，一般几分钟就能通过）
• 切换到Keys and tokens页面，确保你的应用权限至少是Read and write（只读权限无法获取邮箱）

2. 完善django-allauth的Twitter Provider配置 #

除了SOCIALACCOUNT_QUERY_EMAIL = True，还需要在settings.py里给Twitter Provider添加详细配置，明确请求邮箱字段：

# settings.py
SOCIALACCOUNT_QUERY_EMAIL = True

SOCIALACCOUNT_PROVIDERS = {
    'twitter': {
        'APP': {
            'client_id': '你的Twitter Client ID',
            'secret': '你的Twitter Client Secret',
        },
        # 关键：必须请求email权限
        'SCOPE': ['email'],
        # 必须使用OAuth2协议，OAuth1不支持获取邮箱
        'METHOD': 'oauth2',
        # 指定需要从Twitter API获取的字段，包含email
        'FIELDS': [
            'id',
            'email',
            'name',
            'screen_name',
            'profile_image_url',
        ],
        # 根据需求设置是否信任Twitter返回的验证邮箱状态
        'VERIFIED_EMAIL': False
    }
}

这里要重点注意：必须使用OAuth2协议，Twitter的OAuth1接口已经废弃了邮箱获取的能力，而且SCOPE里一定要包含email，否则API不会返回邮箱数据。

3. 安全处理pre_social_login信号中的邮箱获取 #

即使配置正确，也可能因为网络波动、API返回异常等情况导致extra_data里没有email字段，所以不要直接用索引取值，改用.get()方法避免KeyError：

from allauth.socialaccount.signals import pre_social_login
from django.dispatch import receiver

@receiver(pre_social_login)
def handle_pre_social_login(sender, request, sociallogin, **kwargs):
    # 安全获取邮箱，不存在则返回None
    email = sociallogin.account.extra_data.get('email')
    if email:
        # 这里写你的业务逻辑，比如关联已有邮箱用户、创建用户等
        print(f"获取到Twitter用户邮箱：{email}")
    else:
        # 未获取到邮箱的处理逻辑，比如引导用户手动输入邮箱
        print("未获取到Twitter用户邮箱，请手动补充")

4. 最后一步：清理缓存重新测试 #

有时候django-allauth的缓存会导致配置不生效，建议：

• 重启Django开发服务器
• 清除浏览器的缓存和Cookie，重新发起Twitter授权登录流程

内容的提问来源于stack exchange，提问作者Shift 'n Tab