HMS Map toolkit调用getMapAsync()后onMapReady()未回调 非法指纹错误排查

该错误本质为AppGallery Connect后台配置的证书指纹与APK实际使用的签名指纹不匹配，可按以下步骤逐一排查：

• 核对实际打包所用签名文件的SHA256值
  不要直接使用Android Studio Gradle面板signingReport任务的默认输出（默认读取的是系统debug.keystore的指纹），直接通过命令行查询你打包实际使用的签名文件：

  keytool -list -v -keystore 你的签名文件路径 -alias 你的签名别名
  

  输入密钥库密码后，完整复制输出的SHA256证书指纹，不要删减字符、修改格式。
• 核对AppGallery Connect后台配置
  进入对应项目的应用信息页，确认「SHA-256证书指纹」栏填写的内容和你刚才复制的指纹完全一致。如果修改了后台配置，需要重新下载agconnect-services.json文件，替换到项目app模块的根目录，再清理项目缓存重新打包。
• 核对项目签名配置
  检查app层级build.gradle中的signingConfigs配置，确认签名文件路径、别名、密码与你实际使用的签名文件完全一致，同时buildTypes下对应的debug、release配置都正确引用了配置好的signingConfig，避免出现测试包用自定义签名、release包未配置签名的情况。
• 升级AGCP插件版本
  你当前使用的com.huawei.agconnect:agcp:1.2.1.301版本过旧，旧版本存在签名读取异常的已知问题，建议升级到1.9.1.301及以上版本，升级后同步Gradle、清理缓存再重新构建项目。
• 重置本地缓存
  以上配置确认无误后，先卸载设备上已安装的旧版应用，再清理设备上HMS Core的缓存（路径：设置-应用-应用管理-HMS Core-存储-清空缓存），最后安装新打包的APK测试。

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