Django Admin添加社交应用无Provider下拉选项及配置错误问题

核心排查与解决步骤 #

• 验证INSTALLED_APPS配置
  确保allauth相关模块及对应认证提供商完整且无拼写错误地添加到配置中：

  INSTALLED_APPS = [
      # 其他Django内置应用
      'django.contrib.sites',
      'allauth',
      'allauth.account',
      'allauth.socialaccount',
      # 第三方认证提供商
      'allauth.socialaccount.providers.google',
      'allauth.socialaccount.providers.facebook',
      'allauth.socialaccount.providers.microsoft',
  ]
  

• 强制设置SITE_ID
  在settings.py中明确添加SITE_ID = 1，django-allauth依赖sites框架，未配置该值会导致认证提供商无法被识别加载，进而出现下拉菜单为空、未知provider的错误。

• 重新配置社交应用
  完成上述两步后重启Django服务，再进入Django Admin的Social Applications页面：

  1. Provider下拉菜单将显示已安装的选项；
  2. 选择对应提供商，填写客户端ID、密钥；
  3. 在Sites关联区域，添加你创建的127.0.0.1:8000站点并保存。

• 清理缓存并重启服务
  执行python manage.py clearcache清除Django缓存，再重启开发服务器，确保新配置完全生效。

• 检查模板中的provider名称
  模板内{% provider_login_url 'google' %}中的provider名称必须为小写且与安装的提供商匹配（如google、facebook），大小写错误会触发"unknown provider"报错。

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