Android端Play Games偶发成就消失、存档异常问题排查问询

一、SHA-1配置存在的问题 #

你当前的SHA-1配置不完整，是导致成就异常的核心原因之一：

• 你仅配置了Google Play应用签名密钥的SHA-1，未补充**上传密钥（Upload key certificate）**的SHA-1凭证
• 你需要在Google Cloud Console新增同包名的Android类型OAuth 2.0 Client ID，填写上传密钥的SHA-1
• 两种签名指纹都要配置的原因：本地调试包、上传前的本地构建包使用上传密钥签名，而Internal Test渠道下载的包由Google Play用应用签名密钥重签，两类签名的请求都会访问Play Games服务，指纹不全会触发服务端校验冲突，导致成就状态回退、成就列表加载失败

二、遗漏的配置步骤 #

• 检查Google Play Console中Play Games Services下的所有成就、排行榜配置的状态，确认全部设置为已发布，草稿状态的配置会出现偶发加载失败、测试账号权限波动的问题
• 检查AndroidManifest.xml的权限配置，除已添加的APP_ID meta-data外，必须补充两项权限声明：

  <uses-permission android:name="com.google.android.gms.permission.PLAY_GAMES" />
  <uses-permission android:name="com.google.android.gms.permission.SAVE_GAMES" />
  

  缺少SAVE_GAMES权限会直接导致存档读写异常，出现空字节、无法恢复进度的问题
• 确认Firebase Console中填写的Web类型Client ID、Client Secret，与Play Games Services关联的Google Cloud项目所属的Web凭证完全一致，跨项目的凭证会导致用户授权状态异常，触发数据同步错误

三、实现逻辑优化建议 #

• 解锁成就时增加防抖逻辑，避免网络波动时重复调用解锁接口，多次重复请求会触发服务端冲突校验，导致成就状态被回滚为锁定
• 存档写入前先校验字节流长度不为0再提交，读取时增加异常捕获逻辑，判断返回的Snapshot对象和内容合法后再执行解析

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