Firebase Firestore 인덱스 삭제 질문 해결: 배포 중 안전하게 판단하기

학습 목표와 사전 지식

목표: 인덱스 삭제 질문의 의미를 읽고 실행 중인 쿼리와 비교해 보존·삭제를 결정합니다.
사전 지식: firebase deploy, 복합 쿼리, 버전 관리

Would you like to delete these indexes?는 로컬 정의와 원격 인덱스 차이를 정리할지 묻는 질문입니다. 필요 여부를 모르면 N으로 보존하고 조사합니다. 문서는 지워지지 않아도 쿼리가 실패할 수 있습니다.

최소 재현 조건

개발 프로젝트 Console에 복합 인덱스를 만든 뒤 로컬 firestore.indexes.json에 그 정의가 없는 상태에서 인덱스 배포를 시도하면 삭제 후보가 표시될 수 있습니다. CLI 버전에 따라 문구가 다를 수 있습니다. 실제 운영 인덱스를 시험 삼아 삭제할 필요는 없습니다.

터미널 · 읽기 확인 명령; 출력의 대상 프로젝트와 정의를 로컬에서 비교

firebase --version
firebase use
firebase firestore:indexes --project YOUR_PROJECT_ID

수정 위치: firestore.indexes.json

예를 들어 reviews에서 productId == 값, createdAt 내림차순을 사용하는 화면이 살아 있다면 아래 정의를 기존 indexes 배열에 병합합니다. 파일 전체를 예시 하나로 덮어쓰지 않습니다. Console에서 만든 인덱스가 코드에 누락된 경우 삭제보다 정의를 회수하는 것이 먼저입니다.

firestore.indexes.json · 최소 파일 예시; 실제 파일에는 기존 정의를 보존

{
  "indexes": [
    {
      "collectionGroup": "reviews",
      "queryScope": "COLLECTION",
      "fields": [
        {
          "fieldPath": "productId",
          "order": "ASCENDING"
        },
        {
          "fieldPath": "createdAt",
          "order": "DESCENDING"
        }
      ]
    }
  ],
  "fieldOverrides": []
}

판단	선택·조치
사용 중인 쿼리·관리자 화면·구버전 앱이 존재	N, 원격 정의를 코드로 가져오기
참조 여부를 모름	N, 호출 위치와 배포 버전 조사
모든 호출 제거와 롤백 영향 검토 완료	별도 변경으로 삭제 검토

조회 성공으로 확인해야 하는 이유

인덱스 생성은 빌드 시간이 필요합니다. 배포 명령 종료만으로 모든 쿼리가 준비됐다고 보지 말고 Console에서 준비 상태를 확인한 뒤 실제 복합 쿼리와 페이지네이션을 실행합니다. 에뮬레이터는 복합 인덱스 요구를 운영과 동일하게 강제하지 않으므로 이 확인은 개발용 실제 Firestore에서도 필요합니다.

삭제 후 문제라면

저장한 정의를 복원해 다시 배포하고 생성 완료까지 기다립니다. 재생성이 가능하다는 말은 즉시 복구를 뜻하지 않습니다. 삭제 후보·결정 이유·영향 쿼리·복원 파일을 함께 기록하면 다음 배포 때 같은 질문을 반복 조사하지 않아도 됩니다.

직접 확인할 결과

원격 인덱스와 로컬 JSON 필드 순서 대조
실제 개발 DB 쿼리 확인
재생성 대기·롤백 계획 기록

검증 범위와 기준일

공식 문서 확인일: 2026-09-13. 웹 SDK 예제는 모듈형 API 기준입니다. 이 글의 코드·구조 정적 검토와 실제 클라우드 인증·저장·배포 검증을 구분합니다. 본인 개발 Firebase 프로젝트의 실제 인증·권한·배포 요청은 이 편집 환경에서 실행하지 않았습니다.

이어서 학습하기

• Firebase 배포 제외 파일 설정: firebase.json의 ignore 사용법
• Firebase Auth unauthorized-domain 오류 해결: 로그인 도메인 설정 확인

공식 문서

• https://firebase.google.com/docs/firestore/query-data/indexing
• https://firebase.google.com/docs/emulator-suite/connect_firestore