Firebase 로컬 에뮬레이터 도구 모음 FAQ 및 문제 해결

Local Emulator Suite 로그에 '단일 프로젝트 모드에서 여러 projectIds가 권장되지 않음'으로 시작하는 오류가 표시되는 이유는 무엇인가요?

이 메시지는 Local Emulator Suite가 다른 프로젝트 ID를 사용하여 특정 제품 에뮬레이터를 실행하고 있음을 감지했음을 의미합니다. 이는 잘못된 구성을 나타낼 수 있으며 에뮬레이터가 서로 통신을 시도할 때, 그리고 개발자가 코드에서 에뮬레이터와 상호작용하려고 할 때 문제를 일으킬 수 있습니다. 프로젝트 ID가 일치하지 않는 경우 종종 데이터가 누락된 것으로 나타납니다. 에뮬레이터에 저장된 데이터는 프로젝트 ID에 연결되고 상호 운용성은 일치하는 프로젝트 ID에 따라 달라지기 때문입니다.

이는 개발자들 사이에서 자주 발생하는 혼동의 원인이므로 기본적으로 Local Emulator Suite은 firebase.json 구성 파일에 별도로 지정하지 않는 한 단일 프로젝트 ID로만 실행하는 것을 허용합니다. 에뮬레이터에서 프로젝트 ID를 두 개 이상 감지하면 경고를 로깅하고 치명적인 오류를 발생시킬 수 있습니다.

다음에서 프로젝트 ID 선언의 불일치를 확인하세요.

• 명령줄에 설정된 기본 프로젝트. 기본적으로 프로젝트 ID는 시작 시 firebase init 또는 firebase use로 선택한 프로젝트에서 가져옵니다. 프로젝트 목록을 보고 어떤 프로젝트가 선택되었는지 확인하려면 firebase projects:list를 사용하세요.
• 단위 테스트. 일반적으로 프로젝트 ID는 규칙 단위 테스트 라이브러리 메서드 initializeTestEnvironment 또는 initializeTestApp을 호출할 때 지정됩니다. 다른 테스트 코드는 initializeApp(config)로 초기화할 수 있습니다.
• 명령줄의 --project 플래그. Firebase CLI --project 플래그를 전달하면 기본 프로젝트가 재정의됩니다. 플래그 값이 단위 테스트 및 앱 초기화의 프로젝트 ID와 일치하는지 확인해야 합니다.

플랫폼별 확인할 위치:

단일 프로젝트 모드를 사용 중지하려면 singleProjectMode 키로 firebase.json을 업데이트합니다.

{
  "firestore": {
    ...
  },
  "functions": {
    ...
  },
  "hosting": {
    ...
  },
  "emulators": {
    "singleProjectMode": false,
    "auth": {
      "port": 9099
    },
    "functions": {
      "port": 5001
    },
    ...
  }
}