Django集成Google-OAuth2验证Flutter端access_token时提示凭证错误

1. 核对Google OAuth2后端配置 #

• 确认settings.py中SOCIAL_AUTH_GOOGLE_OAUTH2_KEY和SOCIAL_AUTH_GOOGLE_OAUTH2_SECRET与Google Cloud控制台的客户端ID、密钥完全一致
• 登录Google Cloud控制台，确保已启用People API（django-social-auth依赖此接口获取用户信息）
• 检查OAuth 2.0客户端ID的授权回调域名配置，即使是token验证场景，错误的域名配置也可能导致权限验证失败

2. 验证Flutter传来的Access Token有效性 #

• 复制Flutter端获取的access_token，调用Google官方验证接口：

  curl "https://www.googleapis.com/oauth2/v3/tokeninfo?access_token=你的token值"
  

  查看返回结果：
  • 若返回invalid_token，说明token本身无效，需排查Flutter端获取token的逻辑
  • 若返回expired_token，则token已过期，需重新获取
  • 确认返回的aud字段与Google Cloud控制台的客户端ID一致，不一致则表示token不属于当前应用

3. 检查Django Social Auth配置与版本 #

• 确保安装的是最新版social-auth-app-django，避免旧版本的兼容性问题：

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

• 确认INSTALLED_APPS包含social_django：

  INSTALLED_APPS = [
      # ...其他应用
      'social_django',
  ]
  

• 检查SOCIAL_AUTH_PIPELINE配置，确保包含必要的用户信息获取步骤（默认配置通常已包含，若自定义过需核对）：

  SOCIAL_AUTH_PIPELINE = (
      'social_core.pipeline.social_auth.social_details',
      'social_core.pipeline.social_auth.social_uid',
      'social_core.pipeline.social_auth.auth_allowed',
      'social_core.pipeline.social_auth.social_user',
      'social_core.pipeline.user.get_username',
      'social_core.pipeline.user.create_user',
      'social_core.pipeline.social_auth.associate_user',
      'social_core.pipeline.social_auth.load_extra_data',
      'social_core.pipeline.user.user_details',
  )
  

4. 捕获详细错误信息 #

修改接口代码，捕获AuthFailed异常以获取具体错误原因：

from social_core.exceptions import AuthFailed

@api_view(['POST'])
@permission_classes([AllowAny])
@psa()
def register_by_access_token(request, backend):
    token = request.data.get('access_token')
    try:
        user = request.backend.do_auth(token)
    except AuthFailed as e:
        return Response(
            {
                'errors': {
                    'token': f'验证失败: {str(e)}'
                    }
            },
            status=status.HTTP_400_BAD_REQUEST,
        )
    if user:
        token, _ = Token.objects.get_or_create(user=user)
        return Response(
            {
                'token': token.key
            },
            status=status.HTTP_200_OK,
            )
    else:
        return Response(
            {
                'errors': {
                    'token': 'Invalid token'
                    }
            },
            status=status.HTTP_400_BAD_REQUEST,
        )

通过返回的具体错误信息，能更精准定位问题（比如权限不足、用户信息获取失败等）

5. 确认请求的Backend参数正确 #

确保请求URL中的backend参数为google-oauth2，比如正确的请求路径是：

POST /api/register-by-access-token/social/google-oauth2/

若误传为google或其他值，会导致加载错误的后端处理逻辑，引发验证失败

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