비공개 테스트에서 Google 로그인 오류 10 해결하기

이 글은 한 가지 문제만 다룹니다. Google Play가 배포한 앱에서만 네이티브 Google 로그인이 실패하는 경우입니다. 비슷해 보이는 다른 오류와 이 문제를 구분한 다음, 프레임워크별 확인 사항, 다른 로그인 제공업체, 테스터가 보고해야 할 내용을 차례로 설명합니다. 인용한 Google 페이지는 모두 2026년 10월 16일에 확인했으며, 커뮤니티 보고는 그렇다고 명시했습니다. 출처는 글 끝에 정리되어 있습니다.

Play 빌드에서 Google 로그인 문제 해결하기

테스터가 설치한 앱과, 그 앱에 등록된 패키지 이름 및 서명 SHA-1을 일치시키세요. 아래 단계를 순서대로 진행하면 되며, Firebase 경로와 Google Cloud 경로는 그 뒤에 이어집니다.

Firebase에 Play 인증서 추가하기

Play 서명 지문을 추가하기 전에 일치하는 Android 앱을 선택하세요. 아래 단계는 Firebase의 지문 도움말과 Google 로그인 가이드를 따릅니다.

1. Firebase Console에서 앱이 사용하는 프로젝트를 연 뒤 Project settings > General(프로젝트 설정 > 일반)로 이동합니다.
2. Your apps(내 앱)에서 패키지 이름이 실패하는 빌드와 일치하는 Android 앱을 선택합니다.
3. Add fingerprint(디지털 지문 추가)를 클릭하고 Play 앱 서명 SHA-1을 붙여 넣은 뒤 저장합니다. 기존 지문을 대체하지 말고 그 옆에 추가하세요.
4. Authentication > Sign-in method에서 Google이 사용 설정되어 있는지 확인합니다.
5. Firebase가 업데이트된 google-services.json을 다운로드하라고 안내하면 프로젝트의 파일을 교체하세요. Firebase는 이 파일에 “Google 로그인에 필요한 OAuth 클라이언트 정보가 들어 있다”고 설명하므로, 파일이 바뀌었다면 새 빌드가 필요합니다. 파일의 프로젝트와 패키지가 실패하는 앱과 일치하는지 확인하세요.

SHA-256은 특정 Firebase 서비스가 요구하는 경우에만 추가하세요. 예를 들어 전화 인증은 Play Integrity 경로에 SHA-256을 사용합니다. Google 로그인 자체는 SHA-1을 기준으로 합니다.

Firebase 없이 Google Cloud 구성하기

두 개의 OAuth 클라이언트는 서로 다른 역할을 합니다. Android 클라이언트는 앱을 등록하고, 웹 클라이언트 ID는 토큰 요청에 사용됩니다.

1. 클라이언트 ID를 발급한 프로젝트를 선택한 뒤 Google Auth platform > Clients를 엽니다(Google Cloud 도움말).
2. 새로 만들기 전에 이 패키지 이름과 SHA-1을 가진 Android 클라이언트가 이미 있는지 확인합니다.
3. 없다면 Create Client를 선택하고 Application type을 Android로 설정한 뒤, 이름, 패키지 이름, Play 앱 서명 SHA-1을 입력하고 Create를 누릅니다. Android 양식에는 SHA-1 입력란이 있으며, SHA-256은 이곳에 넣지 않습니다.
4. 필요한 패키지와 인증서 조합을 각각 등록합니다. 예를 들어 디버그, 로컬 릴리스, Play용입니다.
5. 토큰 요청용 웹 클라이언트는 그대로 두고, 클라이언트 보안 비밀(client secret)은 절대 앱 안에 넣지 마세요.

해결되었는지 검증하기

한 번 로그인에 성공했다고 해서 릴리스가 고쳐졌다는 증거는 아닙니다. 이 체크리스트는 Google 규칙이 아니라 저희가 권장하는 인수 테스트입니다. 마지막 행이 중요한 이유는, 한 개발자의 경우 처음에는 로그인이 통과했지만 다음 로그인에서 다시 실패했기 때문입니다. 한 번만 확인해서는 놓치는 세션 문제였습니다.

디버그에서는 로그인이 되는데 비공개 테스트에서는 왜 실패할까요?

Google Play를 통해 설치된 앱은 로컬에서 설치하는 APK와 서명자가 다를 수 있습니다. Google의 클라이언트 인증 가이드에는 “Android 스튜디오는 디버그 인증서로 앱에 자동으로 서명합니다”라고 나와 있습니다. 직접 빌드한 릴리스는 해당 변형에 구성된 키로 서명됩니다. Play App Signing을 사용하면 업로드 키는 업로드하는 번들에 서명하고, 테스터가 받는 APK에는 Google이 앱 서명 키로 서명합니다.

이 키들은 역할이 다르지만 값이 항상 다른 것은 아닙니다. 직접 서명 키를 제공할 수도 있고, 하나의 키를 두 가지 역할에 쓰는 구성도 있습니다. 키 이름이 아니라 실제 지문을 비교하세요.

지문을 직접 확인하기

내 컴퓨터에서 만든 빌드라면 Gradle 서명 보고서가 모든 변형의 SHA-1과 SHA-256을 출력하고, keytool로 디버그 키 저장소를 직접 읽을 수 있습니다(요청되면 키 저장소 비밀번호를 입력하세요).

./gradlew signingReport

keytool -list -v -alias androiddebugkey -keystore ~/.android/debug.keystore

로컬 서명 보고서로는 Play 설치본에 무엇이 서명했는지 알 수 없습니다. 실패하는 빌드 자체를 확인하려면 비공개 테스트에서 기기에 앱을 설치하고, adb로 APK를 가져온 뒤 apksigner로 인증서를 출력하세요. Google 문서에 따르면 apksigner는 “APK의 서명 인증서 정보”를 보여 줍니다. 패키지 이름을 바꾸고, 첫 번째 명령이 출력한 경로를 사용하세요.

adb shell pm path com.example.app
adb pull /data/app/.../base.apk failing-play.apk
apksigner verify --print-certs failing-play.apk

SHA-1을 추가했는데도 계속 실패합니다

설정을 더 바꾸기 전에 실패하는 APK의 인증서, 최종 애플리케이션 ID, 클라이언트 ID를 비교하세요. 아래 단계를 위에서부터 차례로 확인하면 각 행마다 원인 하나를 배제할 수 있습니다.

4번 행은 이론이 아닙니다. 2026년 9월에 보고된 Expo 사례에서는 지문을 추가해도 아무것도 달라지지 않았고, 실제 원인은 백엔드가 허용하는 클라이언트 ID의 오타였습니다.

여러 개의 서명 인증서 또는 업그레이드된 키

하나의 앱에 서명 신원을 두 개 이상 등록해야 할 수도 있습니다. Google의 최신 Play App Signing 도움말은 세 개의 앱 서명 키를 사용하는 하이브리드 서명을 설명하며 각 키의 지문을 모두 등록하라고 안내합니다. 또한 서명 키를 업그레이드한 앱에도 이전 키로 서명된 설치본이 남아 있을 수 있습니다. 실제 설치본이 가진 신원을 등록하고, 아직 작동하는 기존 항목은 삭제하지 마세요. 키 교체는 이 글의 범위가 아니며, 로그인 문제의 해결책도 아닙니다.

다른 프로젝트가 이미 이 패키지와 SHA-1을 사용 중인 경우

Firebase의 충돌 도움말에 따르면 패키지 이름과 SHA-1 조합은 “모든 Firebase 및 Google Cloud 프로젝트에서 고유해야” 합니다. 다른 프로젝트가 지문을 이미 갖고 있어서 Console이 등록을 거부한다면, 무엇이든 삭제하기 전에 해당 OAuth 클라이언트를 어느 프로젝트가 소유하는지부터 찾으세요. Google 지원팀이 충돌 위치를 찾는 데 도움을 줄 수 있습니다. 추측으로 활성 클라이언트나 프로젝트를 삭제하지 마세요.

오류 10은 12500, 12501, canceled와 같은 오류인가요?

아닙니다. 실패한 로그인을 모두 하나의 문제로 취급하기 전에, 정확한 오류와 그 오류를 낸 라이브러리를 확인하세요. Google의 공통 상태 코드 참조 문서는 DEVELOPER_ERROR = 10을 “애플리케이션이 잘못 구성되었습니다”로 정의합니다. 아래의 다른 코드는 Google의 이전 play-services-auth 21.6.0 SDK에서 나온 것입니다.

기존 Google 로그인과 Credential Manager

Google의 Play 서비스 출시 노트에는 2024년 4월 16일 play-services-base에서 Google 로그인 API가 지원 중단되었다고 나와 있으며, Google은 2024년 9월 11일 Credential Manager로의 전환을 발표했습니다. 이후 이 API는 2026년 8월 26일 play-services-auth 22.0.0에서, 2026년 9월 17일 play-services-base 18.11.0에서 “Google 로그인 관련 API를 삭제했습니다”라는 안내와 함께 제거되었습니다. 이것은 SDK 변경이며, 이미 설치된 앱의 서비스 종료일을 의미하지는 않습니다. 새 코드와 업그레이드는 Google의 이전 가이드를 따르세요.

두 API는 실패하는 방식이 다릅니다. Credential Manager에는 오류 10이 없으며, 문제 해결 가이드는 “"취소"가 많이 발생한다면 실제로는 구성 오류일 수 있습니다”라고 경고합니다. 따라서 취소는 구성 오류일 수도, 실제 취소일 수도 있으며, NoCredentialException은 또 다른 신호입니다.

Flutter, React Native, Expo, Unity 확인 사항

위의 네이티브 신원 확인은 모든 프레임워크에 적용되지만, 설정, 초기화, 빌드 구성은 프레임워크마다 다릅니다. 사용하는 프레임워크의 경로와 앱에 실제로 적용된 라이브러리 버전을 기준으로 확인하세요.

React Native의 경우 라이브러리 관리자가 프로젝트 루트에서 실행할 수 있는 구성 확인 도구를 제공합니다.

npx @react-native-google-signin/config-doctor

Supabase, Facebook, Apple, Auth0에서는 무엇이 달라지나요?

어떤 인증서, 클라이언트 ID, 콜백이 일치해야 하는지는 제공업체와 로그인 흐름에 따라 결정됩니다. Google SHA-1은 네이티브 Google 로그인의 해답이지만, 다른 제공업체에서는 잘못된 해시이거나, 잘못된 형식이거나, 아예 관련이 없을 수 있습니다.

테스터는 개발자에게 무엇을 보내야 하나요?

유용한 보고서는 실패하는 Play 빌드와 로그인이 멈추는 정확한 지점을 알려 줍니다. 테스터가 다시 시도한다고 OAuth 등록이 고쳐지지는 않으므로, 테스터의 역할은 반복 시도가 아니라 증거 수집입니다. 이 템플릿을 복사해 테스터에게 보내세요.

앱 및 Play 테스트 링크:
설치된 앱 버전 또는 빌드:
설치 경로: Play 비공개 테스트 / 기타 경로
기기 및 Android 버전:
날짜, 시간, 시간대:
정확한 오류 문구 또는 개인정보를 가린 스크린샷:
멈춘 지점: 계정 선택 화면 전 / 계정 선택 후 / 앱으로 돌아온 후
다른 로그인 방법으로는 앱을 열 수 있었나요?
재테스트 결과 및 버전:

수정하는 동안 테스터에게 테스트 참여를 유지해 달라고 요청하세요. 비밀번호, OAuth 토큰, 비공개 키, Play Console 액세스는 절대 요청하지 마세요. 수정 후에는 같은 테스터에게 로그인이 필요한 기능을 열어 본 다음 로그아웃했다가 다시 로그인하고, 버전과 결과를 기록해 달라고 요청하세요.

오류 10이 비공개 테스트나 프로덕션 액세스에 영향을 주나요?

로그인 구성 오류는 테스트 참여와는 별개의 문제입니다. 오류 10은 Play 정책 거부 코드가 아니며, 저희가 찾아본 Google 규칙 중에 이 오류로 테스터의 참여 기간이 초기화된다고 한 것은 없습니다. Google의 테스트 요구사항 페이지는 비공개 테스트 기간 중 앱을 개선하도록 권장하므로, 테스터의 참여를 유지한 채 같은 비공개 트랙에 수정 사항을 배포하세요. 이는 공개된 규칙을 해석한 것이며, 모든 경우를 보장하는 약속은 아닙니다.

그렇다고 로그인 오류가 사소한 것은 아닙니다. Google Play의 기능 정책에는 “비정상 종료, 강제 종료, 정지 등 비정상적으로 작동하는 앱은 허용되지 않습니다”라고 나와 있으며, 로그인 장벽이 있으면 테스터가 테스트해야 할 기능에 접근할 수 없습니다. 프로덕션 액세스를 신청하기 전에 문제를 해결하고, 검토자에게 작동하는 로그인 정보를 제공하세요. 이미 검토 결과를 받았다면 Broken Functionality 거부를 참고하세요.

참고로, 2023년 11월 13일 이후에 만든 개인 개발자 계정은 해당 앱의 프로덕션 액세스를 신청하기 전에 최소 12명의 테스터가 14일 동안 지속적으로 테스트에 참여해야 합니다. 신청 후에 대해 Google은 “검토는 일반적으로 7일 이내에 완료되지만 경우에 따라 더 오래 걸릴 수 있습니다”라고 안내합니다. 테스터가 인원수에 집계되지 않는다면, 로그인을 건드리기 전에 테스터를 어떻게 초대했는지 확인하세요.

자주 묻는 질문

핵심 정리

Play Console과 Firebase의 메뉴 이름은 이 페이지에서 가장 빨리 바뀌는 정보입니다. 위의 경로가 내 Console과 더 이상 맞지 않는다면, Play 앱 서명은 Protected with Play에서, 지문은 Firebase 프로젝트 설정의 Android 앱 항목에서 찾아보세요.