Ionic+AngularFire2谷歌登录遇错误码17，求解决方案及最佳实践

我之前在Ionic项目里整合Firebase谷歌登录时，也踩过几乎一样的坑，尤其是Cordova插件的错误码和配置环节的问题，来帮你逐一梳理解答：

1. 是否遗漏了必要的配置步骤？ #

大概率是配置环节出现了疏漏，以下是必须重点检查的关键点：

• 谷歌云平台OAuth配置：
  • 登录谷歌云控制台，找到你的项目，进入「API和服务」→「凭据」页面
  • 确保为Android/iOS平台添加了对应的SHA-1指纹（Android用keytool -list -v -keystore your-keystore.jks生成，iOS通过Xcode获取）
  • 代码中使用的webClientId必须是「Web应用」类型的客户端ID，不能用Android/iOS专属的客户端ID
• Firebase控制台配置：
  • 进入Firebase控制台→你的项目→「Authentication」→「登录方法」，确保已启用「Google」登录提供商
  • 在「Web SDK配置」中填入正确的Web客户端ID，同时把Android/iOS的客户端ID也添加到对应平台的配置项里
• Cordova插件与项目配置：
  • 确认已正确安装插件并添加对应平台：

    cordova plugin add cordova-plugin-googleplus --save --variable REVERSED_CLIENT_ID=com.googleusercontent.apps.xxxxxx
    cordova platform add android ios
    

  • 检查config.xml中是否添加了必要权限，比如Android的网络访问权限：

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.GET_ACCOUNTS" />
    

• 代码中的凭证创建问题：
  你当前直接把res.accessToken传给signInWithCredential是错误的，需要先创建标准的谷歌登录凭证：

  import * as firebase from 'firebase/app';
  import 'firebase/auth';
  
  // ...
  
  this.gPlus.login({ webClientId: '<myClientID>', offline: true })
    .then(res => {
      const credential = firebase.auth.GoogleAuthProvider.credential(res.idToken, res.accessToken);
      return this.afAuth.auth.signInWithCredential(credential);
    })
    .then(user => {
      // 登录成功后的业务逻辑
    })
    .catch(err => console.log(err));
  

2. Ionic移动端实现谷歌登录的更优方案是什么？ #

如果你的项目是Ionic 5及以上版本，优先推荐使用Capacitor的Google Auth插件。相比Cordova插件，它的原生集成更稳定，配置更简洁，不需要处理复杂的Cordova平台适配问题：

方案步骤概览： #

1. 安装Capacitor Google Auth插件：

   npm install @codetrix-studio/capacitor-google-auth
   npx cap sync
   

2. 在谷歌云控制台完成对应客户端ID配置，添加Android/iOS的SHA-1指纹或Bundle ID
3. 代码中实现登录逻辑：

   import { GoogleAuth } from '@codetrix-studio/capacitor-google-auth';
   
   // ...
   
   async googleLogin() {
     const user = await GoogleAuth.signIn();
     const credential = firebase.auth.GoogleAuthProvider.credential(user.authentication.idToken);
     await this.afAuth.auth.signInWithCredential(credential);
     // 处理登录成功后的逻辑
   }
   

如果坚持使用Cordova，就严格按照前面的配置项逐一排查，确保每一步都正确。另外尽量避免使用signInWithRedirect，移动端跳浏览器的用户体验非常差，原生插件才是更优选择。

3. 错误码“17”的具体含义是什么？ #

Cordova Google Plus插件的错误码17对应的是SIGN_IN_FAILED，也就是登录流程触发了失败逻辑，常见原因包括：

• 谷歌云平台的OAuth客户端ID配置错误（比如用了错误的客户端ID类型，或者未添加正确的SHA-1指纹）
• 设备上未安装谷歌服务框架（Android国内设备常见，需要安装GMS组件）
• 设备的谷歌账号登录状态异常（比如账号过期、网络连接问题）
• 插件配置的REVERSED_CLIENT_ID与谷歌云的客户端ID不匹配

你可以先优先排查前面提到的配置项，尤其是SHA-1指纹和客户端ID的正确性，这是触发该错误最常见的原因。

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