Django Allauth配置后Google提供商不显示及报错求助

1. 检查INSTALLED_APPS配置 #

确保settings.py的INSTALLED_APPS中包含Google提供商的专属应用，这是最容易遗漏的关键配置：

INSTALLED_APPS = [
    # 项目原有应用
    'django.contrib.admin',
    'django.contrib.auth',
    # allauth核心应用
    'allauth',
    'allauth.account',
    'allauth.socialaccount',
    # 必须添加这一行，否则识别不到Google提供商
    'allauth.socialaccount.providers.google',
]

2. 验证SOCIALACCOUNT_PROVIDERS格式 #

确认Google的提供商配置无语法错误，Python对缩进、引号格式要求严格：

SOCIALACCOUNT_PROVIDERS = {
    'google': {
        'SCOPE': [
            'profile',
            'email',
        ],
        'AUTH_PARAMS': {
            'access_type': 'online',
        },
        'OAUTH_PKCE_ENABLED': True,
    }
}

3. 执行数据库迁移 #

添加新的社交提供商后，需要更新数据库表结构，否则Admin页面无法加载Google选项：

python manage.py makemigrations
python manage.py migrate

4. 检查模板中的提供商名称 #

确保登录页面模板里调用的提供商名称是小写的google，大小写错误会直接触发unknown provider：

{% provider_login_url 'google' %}

5. 重置缓存与服务 #

如果以上配置都正确但问题依旧，尝试清除缓存并重启服务：

python manage.py clearcache

然后重启你的Django开发服务器，确保新配置被重新加载。

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