Google Play Games登录失败（ApiException: 12501）求助

首先，ApiException 12501表面上是「用户主动取消了登录流程」，但很多时候是项目配置不完整导致的隐性失败（看起来像取消，实际是验证环节通不过）。结合你贴的代码，咱们一步步排查：

一、先查最容易踩坑的配置问题 #

• 核对Web客户端ID是否正确：你代码里用的getString(R.string.default_web_client_id)，必须是Google Cloud Console中对应你游戏项目的Web应用类型OAuth 2.0客户端ID，绝对不能用Android客户端ID。用错ID会直接触发12501错误。
• SHA-1指纹要双端配置：
  • 调试版本：用keytool -list -v -keystore debug.keystore获取指纹，添加到Google Cloud Console的客户端ID配置里；
  • 发布版本：如果用了Google Play应用签名，还要把Play Console里显示的「应用签名证书SHA-1」也同步到Cloud Console；
  • 两边指纹必须完全一致，缺一个都可能导致登录失败。
• 确认Google Play Games服务已启用：去Google Cloud Console的API库，搜「Google Play Games Services」，确保它是开启状态。

二、代码层面的优化点 #

• 替换废弃的startActivityForResult：如果你用的是AndroidX，建议换成registerForActivityResult，旧API在部分场景下会导致回调异常，看起来像是登录被取消：

  // 先注册结果回调
  ActivityResultLauncher<Intent> signInLauncher = registerForActivityResult(
      new ActivityResultContracts.StartActivityForResult(),
      result -> {
          if (result.getResultCode() == Activity.RESULT_OK) {
              Task<GoogleSignInAccount> task = GoogleSignIn.getSignedInAccountFromIntent(result.getData());
              try {
                  GoogleSignInAccount account = task.getResult(ApiException.class);
                  // 这里写登录成功后的逻辑
              } catch (ApiException e) {
                  Log.w("LoginTag", "登录失败，错误码：" + e.getStatusCode());
              }
          }
      });
  
  // 点击事件里调用启动登录
  @Override
  public void onClick(View view) {
      Intent intent = googleSignInClient.getSignInIntent();
      signInLauncher.launch(intent);
  }
  

• 检查GoogleSignInOptions构建逻辑：你用DEFAULT_GAMES_SIGN_IN是正确的，只请求server auth code也没问题，但要确保你的Web客户端ID确实允许接收这个auth code（Cloud Console里要开启对应权限）。

三、设备与测试环境问题 #

• 测试设备必须装最新版Google Play Games：旧版本可能存在兼容性问题，直接导致登录流程卡住触发12501。
• 测试账号要加入内部测试名单：去Google Play Console的「测试 > 内部测试」里，把你的测试Google账号加进去，并且账号要接受测试邀请。没在名单里的账号没法正常登录游戏服务。
• 排查账号状态：确保测试账号没有被限制，比如未完成年龄验证、有违规记录等，这些都会导致登录失败。

四、用日志精准定位 #

在回调里打印详细错误信息，能帮你区分是用户真的取消了，还是配置问题：

catch (ApiException e) {
    Log.e("LoginTag", "错误码：" + e.getStatusCode() + "，详情：" + e.getMessage());
    if (e.getStatusCode() == 12501) {
        Log.e("LoginTag", "可能原因：用户取消登录 / 客户端ID不匹配 / SHA-1配置错误");
    }
}

内容的提问来源于stack exchange，提问作者Ventura De Lucas Sánchez