博客

Play 管理中心「使用的签名密钥不正确(SHA1)」解决办法

Google Play 管理中心上传 .aab 报「使用的签名密钥不正确」(SHA1 不匹配)?详解核对本地密钥库、请求重置上传密钥及 48 小时冷却期的处理办法。

第一个版本明明顺利传上去了,修完几个 Bug 重新打出 .aab,拖进 Google Play 管理中心(Play Console)的创建发布版本页面,上传框下方却立刻跳出红字拦截:

您的 Android App Bundle 使用的签名密钥不正确。请务必使用正确的签名密钥为您的 App Bundle 签名,然后重试。正常情况下应使用具有如下指纹的证书为该 App Bundle 签名: SHA1: <EXPECTED_SHA1>,但您上传的 App Bundle 所用的签名证书的指纹却是: SHA1: <ACTUAL_SHA1>

当你上传某个应用的第一个已签名 .aab 时,Play 管理中心就会把这张证书的 SHA-1 指纹锁定为该应用的上传密钥,此后任何轨道的所有更新版本都必须用同一个密钥库签名。在 14 天封闭式测试期间发更新包、换了新电脑、重新拉代码后漏掉了被 .gitignore 忽略的 .jks、选错了密钥别名(alias),或者在本地 Gradle 打包与 Expo EAS / GitHub Actions 之间切换时,极易触发这个报错。

先不用慌,开启了 Play 应用签名(Play App Signing)的现代 .aab 应用并不会因为弄丢本地密钥而报废。在后台左侧菜单 由 Google Play 提供保护 > Play 商店保护 > 管理 Google Play 应用签名(原「测试和发布 > 应用完整性」已迁至此)打开的应用签名页面中,Google 把密钥拆成了两把:

  • 应用签名密钥(App signing key):由 Google 托管在云端服务器,用来为最终分发给用户手机的安装包签名。
  • 上传密钥(Upload key):由开发者自己保管,仅用于向 Play 管理中心证明「这个 .aab 确实是我本人上传的」。

正因为真正的分发密钥在 Google 手里,就算本地 .jks 彻底找不回来,也不用换包名重建应用——要么把原密钥库找出来,要么在后台申请重置上传密钥即可。

1先核对本地已有的密钥库,别急着点重置

只要原来的 .jks 或 .keystore 还有可能留在旧电脑、网盘或 CI 服务器里,就先不要去后台申请重置——一旦提交重置,新上传密钥会有整整 48 小时的安全冷却期无法传包。

先看清报错里的两个指纹:

  • <EXPECTED_SHA1>:Play 管理中心记录在案的原上传密钥指纹(随时可在应用签名页面的上传密钥 > SHA-1 证书指纹处查看)。
  • <ACTUAL_SHA1>:你刚刚拖进去的这个 .aab 实际使用的证书指纹。

对电脑上所有 .jks 或 .keystore 文件逐一运行 keytool,查看里面的 SHA1 指纹:

keytool -list -v -keystore your-upload-key.jks

在输出结果的 证书指纹(Certificate fingerprints)下核对 SHA1: 一行。如果同一个密钥库里存了多个密钥,请把每个 别名(Alias name:)都看一遍——哪怕 .jks 文件选对了,keyAlias 填错同样会算出完全不同的 SHA1。

动手重置前,先排查这三种最常见的乌龙:

  • 检查 <ACTUAL_SHA1> 是不是系统的 debug.keystore:运行 keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android(Windows PowerShell 请把路径换成 "$env:USERPROFILE\.android\debug.keystore")。如果算出来的 SHA1 正好等于 <ACTUAL_SHA1>,说明你的 release 构建悄悄回退到了调试签名——最常见于 Flutter 项目换电脑后缺少 android/key.properties,配置方法见 Play 管理中心提示「在调试模式下签名」的解决办法。
  • Android Studio、Flutter 与 Unity:打开 android/key.properties(Unity 查看 Project Settings > Player > Publishing Settings > Custom Keystore),确认 storeFile 和 keyAlias 没有指向你其他项目的旧密钥库。
  • Expo(React Native / EAS Build):如果第一个包是在本地打包上传,第二个包改用 eas build 云端构建(或反过来),EAS 很可能在云端自动生成了一套新密钥库。在终端运行:
eas credentials

依次选择 Android → production → Keystore 核对云端密钥的 SHA1。如果 <EXPECTED_SHA1> 在 EAS 云端,就把它下载回本地共用;如果 <EXPECTED_SHA1> 在你本地的 .jks 里,就上传覆盖到 EAS,保证两端使用同一把密钥。

2密钥库彻底遗失?在 Play 管理中心申请重置上传密钥

确认原 .jks 文件或密码彻底找不回来后,按以下三步申请更换上传密钥:

第一步:生成新的 2048 位 RSA 密钥库

keytool -genkeypair -v -keystore new-upload-key.jks -alias upload -keyalg RSA -keysize 2048 -validity 10000

注意务必加上 -validity 10000(约 27 年)。如果不传 -validity,keytool 默认有效期只有 90 天,上传时会因为早于 2033 年 10 月 22 日过期而被 Play 管理中心直接拒收。

第二步:导出 PEM 格式公钥证书

keytool -export -rfc -keystore new-upload-key.jks -alias upload -file upload_cert.pem

第三步:到 Play 管理中心提交 upload_cert.pem

  1. 使用账号所有者身份登录 Play 管理中心,打开左侧菜单的由 Google Play 提供保护,展开 Play 商店保护,点击管理 Google Play 应用签名(如果点进了旧入口「测试和发布 > 应用完整性」,点页面上的「前往“由 Google Play 提供保护”」按钮即可)。
  2. 在上传密钥区域点击请求重置。
  3. 选择重置原因,上传刚刚生成的 upload_cert.pem 并提交。
  4. 将本地 android/key.properties、GitHub Actions Secrets 或 eas credentials 更新为 new-upload-key.jks(keyAlias=upload),重新打好新的 .aab。

3重置获批后的 48 小时冷却期:千万别再重新生成密钥

提交重置申请后,Google 的审批通过邮件通常几分钟就会发到邮箱。很多开发者看到邮件后立刻用 new-upload-key.jks 打包上传,结果上传框又弹出一行红字报错(英文界面原文如下):

You uploaded an app bundle that is signed with an upload certificate that is not yet valid because it has been recently reset. You will be able to upload app bundles again from <Date/Time> UTC.

意思是你上传的软件包使用了刚刚重置、尚未到生效时间的上传证书,需要等到 <Date/Time> UTC 之后才能再次上传。这并不是新密钥配错了——为了防止账号被盗时攻击者悄悄替换上传密钥,Google 在审批通过后强制设置了 48 小时安全等待期,给账号所有者留出发现异常并撤回的时间。

  • 千万不要再去生成第三把密钥,也不要重复提交重置申请!重新生成 .jks 只会让刚打好的包作废,还会把等待时间彻底搅乱。
  • 把报错里的 <Date/Time> UTC 换算成北京时间(UTC 时间加 8 小时),等过了那个时间点,把完全相同的同一个 .aab 重新拖进去就能直接通过,无需重新打包。

4下次发更新前做好这两件事

  • 建好密钥当天就塞进密码管理器备份:.jks 文件和 key.properties 绝不能提交进 Git 仓库(应加入 .gitignore),但也正因如此,重装系统、硬盘损坏或换新电脑 git clone 时最容易把它们丢在旧机器上。生成密钥当天,就把 .jks 作为附件连同 storePassword、keyAlias、keyPassword 一起存进 1Password、Bitwarden 等密码管理器。
  • 本地打包与 CI / EAS 严格共用同一个 .jks:不要让本地 Gradle 用一套密钥、GitHub Actions 或 EAS 云端用另一套密钥。把同一个 .jks 做 Base64 编码后存入 GitHub Actions Secrets(或通过 eas credentials 同步),无论在哪台机器出包,算出来的 SHA1 都永远一致。

14 天封闭式测试期间,保持顺畅迭代很关键

签名校验通过后,如果在发更新包时接着碰到了「已有版本使用了版本代码」或「16 KB 内存页面大小未对齐」等其他拦截,可以对照 Play 管理中心上传 AAB 报错汇总 逐项排查。

把签名环境理顺,在 14 天封闭式测试期间尤为重要:等你申请正式版发布权限时,Google 会重点看测试人员有没有真实使用应用、你有没有根据反馈持续发版修复问题;如果在临近第 14 天修 Bug 时因为丢密钥卡上 48 小时,很容易打乱整个提审节奏(详见 申请正式版被拒"需要进行更多测试"?5 个原因和对策)。

如果你还在找能装上应用、陪你测完整个周期的 12 名测试人员,BetaLobby(完全免费,无付费套餐)提供 16 人组队模式,共用同一个 Google 群组,自动核验真机安装并通过 14 天每日打卡跟进活跃度,让每次发上去的新包都有人真正在手机上打开。