OpenEdx Nutmeg配置OAuth2谷歌登录未显示按钮如何解决

以下是配置流程中最容易遗漏的错误点，按顺序排查即可解决：

• 参数名写错问题：Nutmeg版本调整了OAuth配置的参数前缀，旧教程常用的SOCIAL_AUTH_GOOGLE_OAUTH2_KEY/SOCIAL_AUTH_GOOGLE_OAUTH2_SECRET参数已失效，正确的配置命令为：

  tutor config save \
    --set ENABLE_THIRD_PARTY_AUTH=true \
    --set GOOGLE_OAUTH2_KEY="你从谷歌平台获取的Client ID" \
    --set GOOGLE_OAUTH2_SECRET="你从谷歌平台获取的Client Secret"
  

  配置写入后必须执行全量服务重启与缓存清理，否则配置不会生效：

  tutor local restart lms cms
  tutor local run lms ./manage.py lms cache clear
  

• 后台提供商配置漏选可见性：仅写Tutor全局配置不够，必须登录LMS的Django管理后台（路径为/admin/third_party_auth/oauth2providerconfig/）新建谷歌OAuth2提供商配置，注意三个必填项不能错：
  • Backend name下拉选择google-oauth2
  • 同时勾选Enabled和Visible两个复选框，仅勾选Enabled时系统会加载后端但不会在登录页渲染按钮
  • 关联站点选择你实际对外提供服务的LMS域名，不要保留默认的example.com占位值
• 回调地址配置错误：谷歌云控制台OAuth同意屏的授权重定向URI必须严格匹配格式https://你的LMS正式域名/auth/complete/google-oauth2/，末尾斜杠不能省略，协议必须为HTTPS。如果是本地测试环境需要走HTTP，要额外加配置tutor config save --set OAUTH2_ALLOW_INSECURE_HTTP=true，生产环境禁止开启该参数。部分版本下回调地址不匹配会直接隐藏登录按钮避免报错。
• 自定义主题覆盖模板：如果你部署时启用了自定义主题，需要确认主题的登录页模板保留了第三方登录按钮的渲染片段，可临时切回默认主题验证：如果切回默认主题后按钮正常显示，说明自定义主题删除了对应模板片段，补全third_party_auth/login_button.html的引入即可。

配置完成后可直接访问https://你的LMS域名/auth/login/google-oauth2/做连通性校验：如果能正常跳转到谷歌账号登录页，说明后端配置已生效，清理浏览器缓存后刷新登录页即可看到谷歌登录入口。

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