已部署Django项目：Google+ API登录认证系统升级改造技术求助

嘿，我之前也帮团队处理过类似的Google+ API弃用迁移，给你整理了一套可落地的步骤和技巧，帮你平稳过渡到Google OAuth2：

1. 核心方向：切换到Google OAuth2后端 #

Google+ API弃用后，官方推荐使用Google OAuth2 API，而social-auth-core本身就提供了成熟的OAuth2后端支持，不需要额外引入新库，只需调整配置即可。

2. 第一步：更新social-auth-core到最新版本 #

旧版本的social-auth-core可能对Google OAuth2的支持不完善，甚至还依赖Google+的遗留逻辑，先确保依赖是最新的：

pip install --upgrade social-auth-core

3. 替换Django配置中的认证后端 #

打开你的settings.py，找到认证后端配置项：

• 移除旧的social_core.backends.google.GooglePlusAuth
• 添加social_core.backends.google.GoogleOAuth2

修改后的AUTHENTICATION_BACKENDS示例：

AUTHENTICATION_BACKENDS = [
    'social_core.backends.google.GoogleOAuth2',
    'django.contrib.auth.backends.ModelBackend',
    # 其他你需要的后端...
]

4. 重新配置Google Cloud OAuth2凭据 #

原来的Google+凭据已经失效，需要在Google Cloud控制台创建新的OAuth2凭据：

• 进入Google Cloud控制台，找到「API和服务」→「凭据」
• 创建「OAuth 2.0 客户端ID」，选择「Web应用」类型
• 设置「已获授权的重定向URI」，格式为https://你的生产域名/complete/google-oauth2/（开发环境可添加http://localhost:8000/complete/google-oauth2/用于测试）
• 记录新的「客户端ID」和「客户端密钥」，替换settings.py中的旧配置：

  SOCIAL_AUTH_GOOGLE_OAUTH2_KEY = '你的新客户端ID'
  SOCIAL_AUTH_GOOGLE_OAUTH2_SECRET = '你的新客户端密钥'
  

5. 调整权限范围和字段映射 #

根据你的项目需求，配置需要获取的用户信息权限，比如基本的邮箱和个人资料：

SOCIAL_AUTH_GOOGLE_OAUTH2_SCOPE = [
    'https://www.googleapis.com/auth/userinfo.email',
    'https://www.googleapis.com/auth/userinfo.profile',
]

如果你的用户模型依赖原来Google+返回的特定字段，可以通过SOCIAL_AUTH_GOOGLE_OAUTH2_EXTRA_DATA来映射：

SOCIAL_AUTH_GOOGLE_OAUTH2_EXTRA_DATA = [
    ('id', 'google_id'),
    ('email', 'email'),
    ('name', 'full_name'),
]

6. 更新前端登录入口 #

把原来指向/login/google-plus/的登录按钮链接，改成/login/google-oauth2/，确保用户能跳转到新的授权页面。

7. 测试与验证 #

• 先在开发环境测试：启动本地服务，用测试账号授权，检查是否能正常登录，用户数据是否正确写入数据库
• 生产环境预测试：可以临时添加测试域名到Google Cloud的重定向URI，用内部账号验证流程
• 备份数据库：在生产环境部署前，务必备份用户认证相关的数据，避免迁移出现问题

8. 常见问题处理 #

• 现有用户关联问题：如果原来的用户是通过Google+关联的，social-auth-core会自动根据邮箱匹配现有用户，但若邮箱不唯一，可能需要调整自定义管道（pipeline）来处理
• 自定义逻辑适配：如果你的项目有自定义的认证管道（比如处理用户头像、额外信息），检查是否依赖Google+的特定字段，比如原来的googleplus_id要换成OAuth2返回的sub或id
• 授权错误：如果出现授权失败，先检查重定向URI是否和Google Cloud配置一致，以及权限范围是否正确

参考文档 #

• social-auth-core官方文档中关于Google OAuth2后端的章节，里面有详细的参数配置和管道扩展说明
• Google Cloud控制台内的OAuth2凭据创建向导，自带步骤指引，跟着走就能完成配置

内容的提问来源于stack exchange，提问作者V. Aldo