初回リリースは無事に通ったのに、バグを直して新しい .aab をビルドし、Google Play Console の リリースの作成 画面にドロップした瞬間、アップロード枠の下に赤字で次のエラーが出ることがあります。
Android App Bundle が誤った鍵で署名されています。App Bundle を正しい署名鍵で署名して、もう一度お試しください。App Bundle はフィンガープリント「SHA1: <EXPECTED_SHA1>」の証明書で署名される必要がありますが、アップロードした App Bundle の署名に使われている証明書のフィンガープリントは「SHA1: <ACTUAL_SHA1>」です。
Play Console では、アプリの最初の署名済み .aab をアップロードした時点で、その証明書の SHA-1 フィンガープリントが アップロード鍵 として固定されます。以降のアップデートはどのトラックであっても同じキーストアで署名しなければなりません。14 日間のクローズド テスト中に修正版を出す際によく起きるエラーで、別 PC でのビルド、.gitignore に入れていた .jks の紛失、エイリアス(alias)の指定ミス、あるいはローカルの Gradle ビルドと Expo EAS / GitHub Actions の混用などが主な原因です。
焦る必要はありません。現在の .aab アプリで標準となっている Play アプリ署名(Google Play による保護 > Google Play ストアの保護 > Play アプリ署名の管理、旧「テストとリリース > アプリの完全性」から移動)の アプリの署名 ページでは、次の 2 つの鍵が明確に分かれています。
- アプリ署名鍵:Google のサーバー上で厳重に保管され、ユーザーの端末に配信される最終的な APK の署名に使われます。
- アップロード鍵:デベロッパーが手元に持ち、Play Console へ
.aabをアップロードする際の本人確認だけに使われます。
本番配信用の鍵は Google 側が保持しているため、手元の .jks を紛失してもパッケージ名を捨ててアプリを作り直す必要はありません。元のキーストアを探し出すか、Play Console からアップロード鍵のリセットを申請すれば復旧できます。
1リセットを申請する前に手元のキーストアを確認する
元の .jks や .keystore が別の PC、クラウドストレージ、CI 上に残っている可能性があるなら、いきなりアップロード鍵のリセットを申請しないでください。リセットを行うと、セキュリティ保護のため 48 時間 は新しい .aab を一切アップロードできなくなります。
まずはエラー文に出ている 2 つのフィンガープリントを見比べます。
<EXPECTED_SHA1>:Play Console に登録されている本来のアップロード鍵(アプリの署名 ページの アップロード鍵 > SHA-1 証明書のフィンガープリント 欄でもいつでも確認できます)。<ACTUAL_SHA1>:今回アップロードしようとした.aabに使われていた証明書のフィンガープリント。
PC 内に残っている .jks や .keystore に対して keytool を実行し、SHA1 を突き合わせます。
keytool -list -v -keystore your-upload-key.jks
出力の Certificate fingerprints にある SHA1: の行を確認してください。1 つのキーストア内に複数の鍵が入っている場合は、すべての Alias name: を確認します。.jks ファイルが合っていても keyAlias が違うと、まったく別の SHA1 になります。
リセットなしで解決できる代表的な原因は次の 3 つです。
<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>と一致する場合、リリースビルドがデバッグ署名にフォールバックしています(Flutter で PC 移行後にandroid/key.propertiesがないケースなど)。設定の直し方は 「デバッグモードで署名されています」の対処法 を参照してください。- Android Studio・Flutter・Unity:
android/key.properties(Unity は Project Settings > Player > Publishing Settings > Custom Keystore)を開き、storeFileとkeyAliasが別アプリ用の古いキーストアを指していないか確認します。 - Expo(React Native / EAS Build):初回はローカルでビルドし、2 回目を
eas buildでビルドした場合(またはその逆)、EAS 側で別のアップロード鍵が自動生成されていることがあります。ターミナルで次を実行します。
eas credentials
Android → production → Keystore を選んで EAS 上の SHA1 を確認し、EAS 側が <EXPECTED_SHA1> ならローカル用にダウンロードし、手元の .jks が <EXPECTED_SHA1> なら EAS にアップロードして鍵を統一します。
2キーストアを完全に紛失した場合:Play Console でアップロード鍵をリセットする
元の .jks ファイル(またはパスワード)がどうしても見つからない場合は、次の 3 ステップで新しいアップロード鍵を登録します。
手順 1:新しい 2048 ビット RSA キーストアを作成する
keytool -genkeypair -v -keystore new-upload-key.jks -alias upload -keyalg RSA -keysize 2048 -validity 10000
必ず -validity 10000(約 27 年)を付けてください。-validity を省略するとデフォルトの 90 日 になり、Google Play の有効期限要件(2033 年 10 月 22 日以降)を満たせず別のエラーで弾かれます。
手順 2:公開鍵証明書を PEM 形式で書き出す
keytool -export -rfc -keystore new-upload-key.jks -alias upload -file upload_cert.pem
手順 3:Play Console から upload_cert.pem を提出する
- アカウント所有者 として Play Console にログインし、左メニューの Google Play による保護 を開いて Google Play ストアの保護 を展開し、Play アプリ署名の管理 をクリックします(旧メニューの「テストとリリース > アプリの完全性」を開いた場合は [Google Play による保護] に移動 をクリックします)。
- アップロード鍵 の項目にある リセットをリクエスト をクリックします。
- リセットの理由を選択し、先ほど出力した
upload_cert.pemをアップロードして送信します。 android/key.properties、CI のシークレット、またはeas credentialsをnew-upload-key.jks(keyAlias=upload)に切り替え、新しい.aabをビルドしておきます。
3リセット直後の 48 時間クールダウンで焦らない
アップロード鍵のリセット申請は、数分で承認メールが届くことも珍しくありません。ところが承認メールを見てすぐに new-upload-key.jks で署名した .aab をアップロードすると、今度は次のエラー(日本語 UI でも同趣旨のメッセージ)で止められます。
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 時間のセキュリティ待機期間 が設けられています。
- ここで絶対に別のキーストアを作り直したり、再リセットを申請したりしないでください。3 つ目の
.jksを作ると、せっかく承認されたnew-upload-key.jksが無駄になり、待機時間もやり直しになります。 <Date/Time> UTCを日本時間(UTC + 9 時間)に換算し、その時刻を過ぎてから 同じ.aabファイルをそのまま 再アップロードすれば通ります(再ビルドは不要です)。
4次のアップデートで再発させないために
- キーストア作成当日にパスワードマネージャーへ保管する:
.jksとkey.propertiesは Git リポジトリに含めない(.gitignoreに入れる)のが鉄則ですが、そのぶん OS の再インストールや PC の故障、別マシンでのgit cloneで失われやすいファイルでもあります。作成したその日に、.jksファイル本体とstorePassword・keyAlias・keyPasswordをセットで 1Password や Bitwarden などに保存しておきましょう。 - ローカルと CI / EAS で同じ
.jksを使い回す:ローカルの Gradle ビルドと GitHub Actions / EAS Build で別々の鍵を持たせないことが重要です。1 つの.jksを Base64 エンコードして GitHub Actions の Secrets に入れる(またはeas credentialsで同期する)ことで、どこでビルドしても常に同じSHA1になります。
14 日間のクローズド テスト中にスムーズに更新を出すために
署名エラーを突破したあと、更新時によく続けて出る「バージョン コードはすでに使用されています」や「16 KB メモリのページサイズ」などのエラーに遭遇した場合は、Play Console の AAB アップロードエラー一覧 もあわせて確認してみてください。
署名まわりを整えていつでもアップデートを出せる状態にしておくことは、14 日間のクローズド テストにおいて特に重要です。製品版へのアクセスを申請する際、Google はテスターの利用状況だけでなく、フィードバックを受けて改善アップデートを出したかも見ています。14 日目直前の大事なタイミングで鍵のリセットによる 48 時間停止が重なると、テスト計画が大きく崩れてしまいます(詳しくは Google Play「More testing required」で却下される 5 つの理由と対策)。
そして、修正版を出したあとに欠かせないのが、実際にそのアップデートを開いてくれるテスターの存在です。知人に頼んでも数日で開かれなくなったり、掲示板や SNS の個別募集ではオプトインだけで一度も起動されなかったりすることが珍しくありません。BetaLobby(完全無料・有料プランなし)では、16 人の開発者が共通の Google グループ 1 つで チームモード を組み、スクショ提出不要でインストールを自動確認しつつ、14 日間毎日の チェックイン で配信したアップデートが実機で開かれていることを確認できます。