概要
Android の証明書フィンガープリント不一致を診断し、アプリ更新を壊さずに REGISTERED_WITH_ANOTHER_CERTIFICATE_FINGERPRINT を解決します。
対象: CI 移行、Play アプリ署名の導入、アップロード鍵変更、既存アプリの引き継ぎを行うチーム。
確認手順
- 照会したアーティファクトが Play、他ストア、CI、ローカルのどこから来たか確定する。
- アプリ署名証明書、アップロード証明書、旧鍵を比較する。
- 利用者が実際にインストールするアーティファクトの証明書を確定する。
- 証拠を上書きせず、公式コンソールの復旧または更新手順を使う。
要点
API stateREGISTERED_WITH_ANOTHER_CERTIFICATE_FINGERPRINT
証明書照会したフィンガープリントと不一致
最も危険な誤り違う鍵のローテーション
注意点
署名 ID の誤りは既存利用者の更新を止める可能性があります。所有権や鍵履歴が曖昧なら、本番署名を変える前にエスカレーションしてください。
詳しい解説
証明書の時系列を作る
照会した APK の証明書、Play アプリ署名証明書、Play アップロード証明書、旧リリース鍵、代替ストア鍵を並べ、各鍵が使われたアーティファクトと日付を付けます。
誤っているのが照会値、登録記録、リリース パイプラインのどれかで対応が変わります。既存署名材料を保全して公式手続きを使ってください。計画のない鍵変更はインストール済み利用者の更新を壊します。
- 実際の配布アーティファクトを確認する。
- 鍵エイリアスではなく証明書フィンガープリントを比較する。
- 所有権が曖昧ならリリース前に相談する。
レスポンス例
{
"state": "REGISTERED_WITH_ANOTHER_CERTIFICATE_FINGERPRINT"
}製品版のパッケージ名を入力し、署名も照合する場合は配布 APK の証明書 SHA-256 を追加します。ストア審査やアプリの安全性とは別の確認です。
ステータスを確認 →よくある質問
アップロード証明書を使えば直りますか？
自動的には直りません。Play 配信 APK は通常アプリ署名証明書を使い、CI の送信だけが別のアップロード証明書を使えます。
鍵ローテーションで不一致を解決できますか？
意図した署名 ID を確定し、正しい公式手続きを使う場合だけです。場当たり的な変更は更新の継続性を損ねます。
出典と更新情報
最終確認日: