[Trouble Shooting] Firebase 설정 중 CONFIGURATION_NOT_FOUND 에러 해결 기록

AI(Codex)와 함께 광속으로 질주하던 개발 흐름이 '설정'이라는 현실적인 벽에 부딪혔을 때의 기록입니다.

• ❌ 문제: 회원가입/로그인 시도 시 An internal error has occurred [CONFIGURATION_NOT_FOUND] 에러 발생
• 🔍 원인: Firebase 콘솔 내 Authentication 기능(이메일/비밀번호) 미활성화
• ✅ 해결: Firebase 콘솔에서 해당 로그인 제공업체 활성화 및 설정 적용

문제 상황

에러가 발생한 정확한 시점

Codex가 제안한 개발 단계에 따라 AuthRepositoryImpl을 구현하고, 실제 안드로이드 에뮬레이터에서 회원가입 기능을 테스트하던 순간이었습니다. 프로젝트 세팅은 이미 끝난 상태였기에 당연히 성공할 것이라 예상했습니다.

어떤 동작 중 에러가 노출되었는지

사용자가 이메일과 비밀번호를 입력하고 '회원가입' 버튼을 눌러 Firebase Auth SDK의 createUserWithEmailAndPassword 함수가 호출되는 즉시 발생했습니다.

에러 메시지 원문
An internal error has occurred [CONFIGURATION_NOT_FOUND]

에러 화면

처음 이 에러를 마주했을 때의 상태

코드상으로는 문법적 오류가 보이지 않아 흐름이 잠시 멈췄다.  
에러 로그를 Codex에 전달하자,  
문제의 원인이 앱 내부 로직이 아니라  
Firebase 설정 쪽에 있을 가능성을 먼저 짚어주었다.

이 지점에서  
원인 추적의 방향이 코드가 아닌 외부 설정으로 명확히 이동했다.

---

🔍 원인 분석

실제로 확인한 항목들

문제를 좁히기 위해 가장 기초적인 부분부터 체크리스트를 만들어 하나씩 검증했습니다.

1. google-services.json 존재 여부: app/ 디렉토리에 정상적으로 위치했는지 재확인했습니다.
2. 패키지명 / applicationId 일치 여부: build.gradle.kts의 applicationId와 Firebase 콘솔에 등록된 패키지명이 정확히 일치하는지 대조했습니다.
3. Firebase 콘솔 앱 정보: 프로젝트 ID와 현재 개발 환경의 SHA-1 인증서 지문 등록 상태를 점검했습니다.

프로젝트 구조 및 google-services.json

---

✅ 해결 방법

최종적으로 확인된 원인

원인은 허무하리만큼 간단했습니다. Firebase 프로젝트만 생성했을 뿐, Authentication 메뉴에서 '이메일/비밀번호' 로그인 방식을 활성화(Enable)하지 않았던 것이 실제 문제였습니다.

수정한 항목과 그 이유

1. Firebase 콘솔 접속: 해당 프로젝트의 [Authentication] -> [Sign-in method] 메뉴로 이동했습니다.
2. 제공업체 추가: [이메일/비밀번호]를 선택하고 '사용 설정'을 체크한 뒤 저장했습니다.

Firebase 콘솔 로그인 제공업체 활성화 화면

---

결과 및 검증

수정 후 다시 시도한 동작

Firebase 콘솔 설정을 마친 후, 앱을 다시 빌드하여 동일한 테스트 계정으로 회원가입을 시도했습니다. 에러 재현 없이 성공적으로 가입되었으며, Firebase 콘솔의 Users 탭에 새로운 유저가 생성되었습니다.

Firebase 콘솔에 생성된 유저 목록

---

🧾 정리

• 핵심 원인: Firebase SDK 설치와 별개로, 콘솔 내 개별 서비스 활성화는 필수입니다.
• 대응 기준: CONFIGURATION_NOT_FOUND 발생 시 먼저 Firebase 콘솔의 Sign-in method 설정을 확인하세요.
• 교훈: AI는 설정을 대신해주지는 않지만,  문제의 방향을 어디로 좁혀야 하는지는 명확히 알려준다.