Firebase 실무 오류를 Storage, Auth, Firestore 기준으로 나눠 해결하기
이 글은 Firebase 실무 오류 해결의 대표 허브입니다. Storage, Firestore, Auth, Functions, Hosting 문제가 서로 섞여 보일 때 먼저 이 글에서 증상을 분류한 뒤 상세 해결 글로 이동하면 됩니다.
Firebase 오류를 제품별로 나눠 해결하는 순서
이 글은 Firebase 실무 오류 해결의 대표 허브입니다. Storage, Firestore, Auth, Functions, Hosting 문제가 서로 섞여 보일 때 먼저 이 글에서 증상을 분류한 뒤 상세 해결 글로 이동하면 됩니다.
- 1단계 · 전체 학습·점검 순서 · Firebase 실무 로드맵
- 2단계 · Next.js 초기화 구조 · Firebase 초기화 구조
- 3단계 · Storage 이미지 403·404 · Firebase Storage 이미지 오류 해결
- 4단계 · Storage CORS · Firebase CORS 오류 해결
- 5단계 · Firestore·Storage Rules · Firebase 보안 규칙 설계
- 6단계 · Auth 상태 관리 · Firebase Auth Context 설계
- 7단계 · 권한·배포 확장 · Firebase Custom Claims 사용법
문제 상황 요약
Firebase에서 문제가 생기면 먼저 어떤 제품에서 발생했는지 나눕니다. Storage 이미지는 403, 404, token, Rules, CORS를 보고, Auth 문제는 로그인 상태 유지와 권한 전달을 확인합니다. Firestore 문제는 security rules와 요청 경로, 사용자 uid 조건을 함께 봐야 합니다.
관련 오류 목록
| 문제 상황 | 먼저 확인할 위치 | 연결 글 |
|---|---|---|
| Storage 이미지가 403 또는 404로 깨짐 | download URL, token, Storage Rules, 파일 경로 | Firebase Storage 이미지 오류 해결 |
| Next.js에서 Firebase 초기화가 중복되거나 환경변수가 헷갈림 | firebase.ts, env 값, client/server 경계 | Firebase 초기화 구조 |
| 로그인 사용자 정보를 전역에서 관리해야 함 | AuthContext, onAuthStateChanged, 라우팅 보호 | Firebase Auth Context 설계 |
| 관리자 권한과 일반 사용자 권한을 나눠야 함 | Custom Claims, Admin SDK, Rules 조건 | Firebase Custom Claims 사용법 |
Firebase 오류 해결 순서
- Storage, Firestore, Auth, Hosting 중 어느 영역의 오류인지 먼저 분리합니다.
- 브라우저 콘솔, Network 탭, Firebase Console 로그에서 실제 에러 메시지를 확인합니다.
- 권한 문제라면 로그인 상태, uid, Rules 조건, 파일/문서 경로를 함께 확인합니다.
- 환경변수 문제라면 로컬과 배포 환경의 Firebase config 값을 비교합니다.
- 수정 후 공개 URL, 로그인 사용자, 비로그인 사용자 조건을 나눠 재검증합니다.
개별 글 링크
- Firebase Storage 이미지 오류 해결: 403·404·token·Rules 확인법
- Firebase 초기화 구조: Next.js firebase.ts 설계 기준
- Firebase Auth Context 설계: 로그인 권한과 라우팅 관리하기
- Firebase Custom Claims 사용법: 관리자 권한 구분하기
- Firebase 실무 로드맵
실무 체크리스트
- Firebase config가 로컬과 배포 환경에 모두 등록되어 있는지 확인합니다.
- Storage 공개 파일과 비공개 파일의 경로와 Rules를 분리합니다.
- Firestore Rules는 실제 요청 경로와 uid 조건으로 테스트합니다.
- Auth 상태는 새로고침, 로그아웃, 권한 변경 후에도 일관되는지 확인합니다.
- 관리자 권한은 클라이언트 상태가 아니라 Custom Claims 또는 서버 검증으로 판단합니다.
자주 묻는 질문
Firebase Storage 403은 CORS 문제인가요?
대부분은 먼저 URL, token, Rules 문제를 봐야 합니다. 새 탭 직접 접속도 실패하면 CORS보다 권한과 URL 문제일 가능성이 큽니다.
Firebase config 값은 공개되어도 되나요?
Firebase 웹 config 자체는 클라이언트에 포함될 수 있지만, 보안은 Rules와 Auth 조건으로 지켜야 합니다. Admin SDK 키나 service account는 절대 클라이언트에 두면 안 됩니다.
Firestore permission-denied는 어디부터 보나요?
요청 경로, 로그인 uid, Rules 조건, 문서 소유자 필드를 순서대로 확인합니다. 코드보다 Rules 조건이 실제 데이터와 맞는지가 핵심입니다.