上传debug与release版SHA-1密钥后安卓发布版地图无法使用

• 配置的release SHA-1和实际运行包的签名不匹配：这是最高发的原因。要么是本地导出SHA-1时选错了签名文件、输错了密钥库密码/别名，要么是应用市场开启了二次签名（多数主流应用市场默认开启该能力），你上传的是本地签名文件的SHA-1，但用户从应用市场下载的正式包是平台重新签名后的，签名信息完全不匹配。
• 平台配置的包名和release包实际applicationId不一致：比如构建配置里给release变体加了applicationIdSuffix、多渠道打包修改了包名，但地图开放平台只填写了默认包名。
• release构建的混淆/资源压缩破坏了SDK逻辑：开启minifyEnabled或shrinkResources后，没有添加地图SDK对应的混淆规则，导致SDK初始化类、枚举、资源被混淆或删除，鉴权逻辑无法正常执行。
• 配置本身填写错误或不生效：比如把SHA-256值当成SHA-1填入、复制密钥时多带了空格、同一API Key绑定的签名数量超过平台上限，或者刚修改完配置没等平台同步就开始测试。
• 设备缓存干扰：设备上残留了之前安装的同包名debug版应用的缓存数据，SDK读取到旧的鉴权缓存导致失败。

1. 先确认最终安装包的真实签名信息 #

不要直接从签名文件（.jks/.keystore）导出SHA-1，这种方式很容易因为选错别名、输错密码拿到错误值。最准确的方式是直接从最终安装的APK中提取签名，执行命令：
keytool -printcert -jarfile 你的release安装包完整路径.apk
把命令输出的SHA-1值和地图平台配置的逐字符比对，注意不要遗漏冒号、不要带多余空格。如果是上架应用市场的版本，一定要下载应用市场公开发布的正式安装包来提取签名，如果和本地签名不一致，把应用市场二次签名的SHA-1也添加到平台的密钥配置中。

2. 核对包名一致性 #

直接解压release APK，查看根目录下AndroidManifest.xml中manifest节点的package属性值，和地图平台填写的包名逐字符核对。如果存在多渠道、多环境包名配置，每个不同applicationId的安装包都要单独配置对应API Key，或在平台侧将所有包名+对应签名绑定到同一个可用的API Key上。

3. 检查构建与混淆配置 #

• 先临时关闭release构建的代码混淆与资源压缩，把build.gradle里release变体的minifyEnabled和shrinkResources都设为false重新打包测试，如果此时地图功能正常，说明是混淆规则缺失导致的问题，对照地图SDK的开发文档，把需要keep的类、SDK组件、自定义桥接类全部添加到混淆规则文件中。
• 检查Manifest合并规则，确认debug源集下的Manifest配置没有覆盖release版的API Key，不要在debug专属的Manifest里写死API Key值，避免构建时被替换成debug环境的key。

4. 读取SDK日志定位具体错误 #

连接设备抓logcat日志，过滤地图SDK对应的TAG，鉴权失败时SDK会明确打印错误原因：是SHA-1不匹配、包名不匹配、Key不存在还是服务未开通，根据日志提示直接修改配置即可，不要盲目试错。刚在平台修改完配置后等待3-5分钟再测试，部分平台配置同步存在延迟。

5. 排除缓存与特殊签名问题 #

• 测试前把设备上所有同包名的debug、release旧版本全部卸载干净，清除应用残留数据后再安装新的release包测试，排除旧鉴权缓存的干扰。
• 如果开启了v2/v3签名方案，确认构建过程没有损坏签名块，可升级Android Gradle插件到稳定版本后重新构建，避免因构建工具bug导致签名信息读取异常。
• 确认申请的API Key对应的地图服务处于正常开通状态，没有因账号欠费、应用违规被平台限制服务。

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