🔐 Firebase 가이드

Firebase 승인 도메인 등록하는 법
구글 로그인 오류 해결하기

📅 2026년 5월 16일 ✍️ 뚝딱닷컴 ⏱️ 4분 읽기 👁 -

😤 코드는 맞는데 구글 로그인이 안 된다

Firebase 구글 로그인 코드를 다 붙여넣었다. 버튼도 만들었다. 클릭했더니 오류가 났다. 코드를 다시 봐도 틀린 곳이 없다. AI한테 물어봐도 코드는 맞다고 한다. 그런데 왜 안 될까.

대부분 이 경우의 원인은 Firebase 승인 도메인 등록이 빠진 것이다. 코드가 아니라 Firebase 설정 문제다. 도메인 하나만 추가하면 바로 해결된다.

⚠️

새 도메인을 Netlify에 연결한 직후 로그인이 안 된다면 거의 무조건 이 문제다. 코드를 수정하기 전에 도메인 등록부터 확인하자.

🔒 왜 오류가 나나요?

Firebase는 보안상 등록된 도메인에서만 로그인을 허용한다. 누구나 Firebase 로그인 코드를 복사해서 아무 사이트에나 붙여넣을 수 있기 때문에, Firebase는 "이 도메인에서 오는 요청만 처리할게"라고 미리 허용 목록을 만들어두는 것이다.

처음 Firebase 프로젝트를 만들면 localhost와 Firebase 기본 도메인만 자동으로 등록된다. Netlify에 배포하거나 커스텀 도메인을 연결하면, 그 새 주소는 목록에 없으니 로그인이 막힌다. 새 도메인을 쓸 때마다 Firebase에 등록해야 한다.

💡

이건 Firebase의 버그가 아니다. 보안을 위한 의도된 동작이다. 등록만 하면 바로 해결되니 당황할 필요 없다.

🪜 등록 순서

Firebase 콘솔에서 직접 추가하면 된다. 어렵지 않다.

1
Firebase 콘솔 접속 console.firebase.google.com 에 접속한 후 내 프로젝트를 선택한다.
2
Authentication 메뉴 클릭 왼쪽 사이드바에서 "Authentication"을 찾아 클릭한다. 구글 로그인 설정이 있는 곳이다.
3
Settings 탭 → 승인된 도메인 상단 탭에서 "Settings"를 클릭하면 "승인된 도메인(Authorized domains)" 섹션이 나온다.
4
도메인 추가 "도메인 추가" 버튼을 클릭하고 내 도메인 주소를 입력한다. https:// 없이 도메인만 입력하면 된다. 예: ddukddak.moongle0908.com
5
추가 버튼 클릭 후 저장 입력 후 "추가" 버튼을 누르면 목록에 바로 추가된다. 별도 저장 버튼은 없고 추가되는 즉시 적용된다.

📋 등록해야 할 도메인 목록

내 사이트에서 사용하는 도메인을 전부 등록해두는 게 좋다. 하나라도 빠지면 그 주소에서 로그인이 안 된다.

필수 등록
ddukddak.moongle0908.com
실제 운영 중인 커스텀 도메인. 방문자가 접속하는 주소이므로 반드시 등록해야 한다.
필수 등록
ddukddak.netlify.app
Netlify 배포 시 자동으로 생기는 기본 주소. 커스텀 도메인과 함께 등록해두는 게 좋다.
기본 등록됨
localhost
로컬 개발 환경. Firebase 프로젝트 생성 시 자동으로 등록되어 있다. 별도 추가 불필요.
기본 등록됨
ddukddak-c40c9.firebaseapp.com
Firebase 프로젝트의 기본 호스팅 도메인. 자동으로 등록되어 있다.
💡

도메인을 입력할 때 https:// 나 http:// 없이 도메인만 입력한다. 예를 들어 ddukddak.moongle0908.com 이렇게만 쓰면 된다.

🔄 등록 후에도 오류가 난다면

도메인을 추가했는데도 여전히 로그인이 안 된다면 브라우저 캐시 문제일 가능성이 높다. 브라우저가 이전의 오류 상태를 기억하고 있는 것이다.

강력 새로고침으로 캐시 지우기
Ctrl + Shift + R (Mac은 Cmd + Shift + R)을 누르면 브라우저 캐시를 무시하고 페이지를 다시 불러온다. 이렇게 하면 대부분 해결된다. 도메인 등록 직후 한 번 시도해보자.
시크릿 창에서 테스트하기
브라우저 시크릿 창(Ctrl + Shift + N)에서 사이트를 열고 로그인을 시도해보면 캐시 영향 없이 테스트할 수 있다. 시크릿 창에서 로그인이 된다면 캐시 문제가 확실하다. 일반 창에서도 강력 새로고침하면 해결된다.
그래도 안 된다면
Firebase 콘솔에서 도메인이 정확히 등록됐는지 다시 확인한다. 오타가 있거나 www 유무 차이로 안 될 수 있다. 예를 들어 www.ddukddak.moongle0908.comddukddak.moongle0908.com은 다른 도메인이다. 실제 접속 주소와 정확히 일치해야 한다.

💬 카카오 공유 버튼도 같은 원리다

Firebase만 이런 게 아니다. 카카오 SDK도 등록된 도메인에서만 작동한다. 카카오 공유 버튼을 만들었는데 새 도메인에서 갑자기 안 된다면 역시 도메인 등록 문제다.

카카오 개발자 센터에서 내 앱 → 플랫폼 → Web 플랫폼 등록 메뉴에서 사이트 도메인을 추가할 수 있다. Firebase와 마찬가지로 새 도메인을 쓸 때마다 추가해줘야 한다.


✅ 마무리 — 도메인 바뀔 때마다 꼭 확인하자

처음엔 왜 로그인이 안 되는지 이해하기 어렵다. 코드는 맞는데 오류가 나니까. 하지만 원인을 알고 나면 간단하다. 도메인 등록은 Firebase와 카카오 모두 필수다.

도메인이 바뀔 때마다 두 곳을 확인하는 걸 루틴으로 만들어두면 나중에 당황하지 않는다. Netlify 기본 도메인에서 커스텀 도메인으로 바꿨을 때, 서브도메인이 달라졌을 때 모두 해당된다.

Firebase 구글 로그인 연결부터 도메인 등록까지 전체 과정은 교재 7장에 담겨 있어요.

📖 7장 교재 — Firebase 로그인 전체 과정 보기