Android使用Credential Manager实现Google SSO时遇NoCredentialException问题

一、依赖与版本校验 #

• 确保credentials和credentials-play-services-auth依赖版本一致且为最新稳定版，示例build.gradle配置：

implementation "androidx.credentials:credentials:1.2.0"
implementation "androidx.credentials:credentials-play-services-auth:1.2.0"

• 检查设备上Google Play服务版本≥23.00.00，过低版本会导致Credential Manager功能异常。

二、Asset Links文件验证 #

• 确认SHA-256指纹与当前构建变体（debug/release）严格匹配：debug版用debug密钥指纹，release版用发布密钥指纹，禁止混淆。
• 检查assetlinks.json格式合规性，示例正确格式：

[{
  "relation": ["delegate_permission/common.get_login_creds"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.company.myapp_android",
    "sha256_cert_fingerprints": ["YOUR_SHA256_FINGERPRINT"]
  }
}]

• 确保文件可公开访问，且响应头Content-Type为application/json，无重定向或权限拦截。

三、Client ID配置修正 #

• GetGoogleIdOption.setServerClientId()需填入Web应用类型的Client ID，而非Android应用Client ID。在Google Cloud Console的「API与服务→凭据」中创建Web应用凭据获取对应ID。
• 确认Client ID未设置IP/域名限制，且与OAuth同意屏幕配置的应用信息一致。

四、代码参数补充与优化 #

• 为GetGoogleIdOption添加自动匹配已登录账号配置：

val googleIdOption = GetGoogleIdOption.Builder()
    .setFilterByAuthorizedAccounts(false)
    .setServerClientId(YOUR_WEB_CLIENT_ID)
    .setAutoSelectEnabled(true)
    .build()

• 确保CredentialManager初始化正确：

private val credentialManager = CredentialManager.create(context)

• 避免在Activity生命周期早期（如onCreate未完成）触发登录逻辑，建议在onStart或用户交互事件中执行。

五、OAuth同意屏幕与测试用户配置 #

• 在Google Cloud Console的OAuth同意屏幕中，确保已添加测试用户完整邮箱，且状态为已发布（测试版发布即可，无需正式发布）。
• 确认设备登录的Google账号与测试用户邮箱完全一致。

六、设备端排查 #

• 清除Google Play服务缓存：设置→应用→Google Play服务→存储→清除缓存。
• 退出并重新登录设备上的Google账号，确保账号状态正常。
• 测试设备需搭载完整Google服务框架，避免使用限制Google服务的定制ROM。

七、GetSignInWithGoogleOption错误处理 #

• 错误[16] Account reauth failed多因账号授权异常，可尝试：
  1. 让用户在Google账号设置中移除应用授权后重新授权。
  2. 确认GetSignInWithGoogleOption使用的Client ID为正确的Web应用ID。
  3. 检查OAuth同意屏幕中是否已声明应用请求的权限。

内容的提问来源于stack exchange，提问作者S. L.