Android 인증서 지문 불일치 해결 방법

가이드 요약

Android 인증서 지문 불일치를 진단하고 앱 업데이트를 깨뜨리지 않게 REGISTERED_WITH_ANOTHER_CERTIFICATE_FINGERPRINT를 해결합니다.

대상: CI 마이그레이션, Play 앱 서명 도입, 업로드 키 변경, 기존 Android 앱 인수를 진행하는 팀.

API stateREGISTERED_WITH_ANOTHER_CERTIFICATE_FINGERPRINT

인증서조회한 지문과 불일치

가장 위험한 실수잘못된 키 교체

주의 사항

서명 신원 오류는 기존 사용자의 업데이트를 차단할 수 있습니다. 소유권이나 키 이력이 불분명하면 프로덕션 서명을 바꾸기 전에 담당 채널로 이관하세요.

조회한 APK 인증서, Play 앱 서명 인증서, Play 업로드 인증서, 레거시 출시 키, 대체 스토어 키를 나열하고 각 키가 적용된 아티팩트와 날짜를 표시합니다.

잘못된 항목이 조회값, 등록 기록, 출시 파이프라인 중 무엇인지에 따라 해결 방법이 달라집니다. 기존 서명 자료를 보존하고 공식 콘솔 절차를 사용하세요. 계획 없는 키 변경은 설치된 앱의 업데이트를 막을 수 있습니다.

응답 예시

{
  "state": "REGISTERED_WITH_ANOTHER_CERTIFICATE_FINGERPRINT"
}

운영 패키지 이름을 입력하고, 서명까지 확인하려면 실제 배포 APK의 인증서 SHA-256을 추가하세요. 이 조회는 스토어 심사와 별개입니다.

업로드 인증서가 해결책인가요?

자동으로 그렇지는 않습니다. Play 배포 APK는 보통 앱 서명 인증서를 쓰지만 CI 업로드는 별도 업로드 인증서를 쓸 수 있습니다.

키 교체로 불일치를 해결할 수 있나요?

의도한 서명 신원을 확인하고 올바른 공식 절차를 쓸 때만 가능합니다. 임의 변경은 업데이트 연속성을 해칩니다.

최종 검토일: 2026-09-08