React Native Android端无Firebase实现Google登录遇开发错误如何解决

第一步：先明确具体错误信息 #

你当前的错误捕获逻辑仅打印了错误描述，丢失了关键错误码，先修改catch代码输出全量错误信息：

catch (error) {
  console.log('谷歌登录错误全量信息：', JSON.stringify(error, null, 2))
}

重新运行复现错误后，可根据返回的错误码快速定位问题：比如错误码10对应签名/包名/客户端ID配置错误，错误码12500对应Google Play服务相关问题。 #

第二步：分维度排查常见问题 #

1. 依赖库版本问题 #

• 你当前使用的@react-native-community/google-signin已经停止维护，对新版本RN、Android 12+系统兼容性极差，建议直接迁移到官方维护的替换库@react-native-google-signin/google-signin
• 升级依赖后要清理原生缓存：进入android目录执行./gradlew clean，再重新打包运行

2. Google Cloud控制台配置问题（无Firebase场景核心校验项） #

• 确认你填写的webClientId是Google Cloud控制台「API和服务」-「凭据」下Web应用类型的OAuth 2.0客户端ID，不要误填为Android类型的ID
• 必须额外创建Android类型的OAuth 2.0客户端ID：
  • 包名必须和你Android项目android/app/build.gradle中defaultConfig下的applicationId完全一致，大小写、特殊字符不能有任何偏差
  • 签名SHA1必须正确：开发环境要填debug签名的SHA1，获取命令为在android目录下执行./gradlew signingReport，取debug变种对应的SHA1值，不要误填发布版SHA1
• 确认OAuth同意屏幕已经配置，测试阶段需要将你用于测试的Google账号添加到「测试用户」列表中，未发布的同意屏幕仅允许列表内账号登录
• 确认Google Cloud控制台已启用「Google Identity API」

3. Android原生配置问题 #

• 检查AndroidManifest.xml中已添加网络权限：<uses-permission android:name="android.permission.INTERNET" />
• 检查android/build.gradle中repositories块已添加google()仓库，且顺序在jcenter()/mavenCentral()之前

4. 代码逻辑优化 #

• 建议在GoogleSignin.configure中补充scope配置，确保有权限获取用户基础信息：

  GoogleSignin.configure({
    webClientId: '你的Web客户端ID',
    scopes: ['profile', 'email'],
    offlineAccess: true
  })
  

• 登录前先调用await GoogleSignin.signOut()清理历史缓存状态，避免旧的无效会话导致报错
• 测试阶段可先关闭offlineAccess参数，验证基础登录功能正常后再开启

5. 测试环境问题 #

• 测试用的模拟器/真机必须搭载Google Play服务，模拟器请选择带「Google Play」标识的系统镜像，无Play服务的设备无法完成登录
• 设备系统时间必须正确，时间偏差过大也会导致OAuth校验失败

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