Django Social Auth接入Google OAuth2报错：Missing required parameter: client_id

我之前踩过这个坑，这个错误基本都是因为Google OAuth2的客户端ID没有正确传递或者配置出了问题，咱们一步步排查解决：

1. 先检查settings.py里的核心配置 #

首先确保你在settings.py里正确配置了Google OAuth2的密钥和相关参数，别漏了关键项：

# settings.py
INSTALLED_APPS = [
    # ... 你的其他应用
    'social_django',
]

AUTHENTICATION_BACKENDS = [
    'social_core.backends.google.GoogleOAuth2',
    'django.contrib.auth.backends.ModelBackend',
]

# 替换成你从Google Cloud拿到的真实值
SOCIAL_AUTH_GOOGLE_OAUTH2_KEY = '你的Google客户端ID'
SOCIAL_AUTH_GOOGLE_OAUTH2_SECRET = '你的Google客户端密钥'

# 回调URL必须和Google Cloud控制台里的完全一致
SOCIAL_AUTH_GOOGLE_OAUTH2_REDIRECT_URI = 'http://localhost:8000/complete/google-oauth2/'

⚠️ 注意：别把密钥硬编码到代码里！推荐用环境变量读取，比如os.environ.get('GOOGLE_OAUTH2_KEY')，避免泄露敏感信息。

2. 核对Google Cloud控制台的配置 #

这一步很容易出错，一定要仔细核对：

• 你在Google Cloud的「API和服务→凭据」里创建的必须是OAuth 2.0 客户端ID，不是服务账号密钥或者其他类型的凭据。
• 「授权重定向URI」必须和settings.py里的SOCIAL_AUTH_GOOGLE_OAUTH2_REDIRECT_URI完全匹配，包括http/https、域名、端口，本地测试一般是http://localhost:8000/complete/google-oauth2/。
• 确认OAuth同意屏幕已经配置完成，如果你还没发布应用，要添加测试用户（否则只有你自己能登录）。

3. 验证模板里的登录链接 #

别手动拼接Google登录的URL！一定要用social-auth提供的模板标签来生成链接，这样才会自动带上client_id参数：

<!-- 你的登录模板文件 -->
{% load socialaccount %}

<a href="{% provider_login_url 'google' %}">用Google账号登录</a>

如果是自己写的URL，很容易漏掉client_id参数，直接导致这个错误。

4. 检查Django Admin里的Social App配置 #

如果你是通过Django Admin来配置Social Auth应用（而不是settings.py），要确保：

• 在Admin的「Social Apps」中，Provider选择「Google」
• 正确填写Client ID和Secret
• 在Sites选项中选中你当前使用的站点（比如localhost:8000）
  ⚠️ 注意：如果同时在settings.py和Admin里配置了，Admin的配置会覆盖settings里的，所以尽量统一一种配置方式，避免冲突。

5. 清除缓存并重启服务 #

有时候旧的配置会被缓存，导致新的配置不生效：

• 清除Django缓存：运行python manage.py clearcache
• 重启Django开发服务器
• 如果用了生产环境的缓存（比如Redis、Memcached），也要同步清除缓存

6. 检查social-auth的版本 #

如果是比较旧的版本，可能存在兼容性问题，尝试更新到最新稳定版：

pip install --upgrade social-auth-app-django social-auth-core

一般按照上面的步骤排查，这个"Missing required parameter: client_id"的问题就能解决啦。

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