사용 팁

Google Firestore 자주 발생하는 오류와 해결 방법

플렉스튜디오에서 파이어스토어를 연동해 애플리케이션을 만들다 보면 오류 메시지를 만나게 되죠. 하지만 대부분은 설정 오류나 입력값 누락 때문에 발생하는 경우가 많아요. 이번 글에서는 파이어스토어 연동 중 자주 만나는 오류와 해결 방법을 소개할게요.

 

플렉스튜디오 유튜브에서 영상 강의 보러 가기👇

 

 

1. 디버거 오류 : firebase system Info is invalid - 서비스 호출이 불가능합니다.

① 원인

  • 디버깅할 때 지정한 테넌트에 서비스 키 설정 문제가 있는 경우
  • 키 파일에 문제가 있는 경우

② 해결 방법

  1. 디버깅할 때 지정한 테넌트에 서비스 키 설정 문제가 있는 경우

• 좌측 상단의 ‘변경’ 버튼을 클릭해 현재 테넌트 확인

2-6 파이어스토어_오류_01


• 서비스 키를 등록했던 테넌트로 변경 → 키 등록 후 반드시 ‘저장’ 버튼 클릭

2-6 파이어스토어_오류_02

 

2. 키 파일에 문제가 있는 경우

• 파이어베이스에서 키를 재발급 → 테넌트 다시 등록

2-6 파이어스토어_오류_03

 

2. 디버거 오류 : 필수 값이 설정되지 않았습니다. - Firestore 컬렉션명을 지정해주세요.

① 원인

  • 시나리오의 시스템 정보 항목에서 Firestore 컬렉션명이 누락된 경우

② 해결 방법

1. 디버그 로그에서 오류 메시지 확인 후, 상위 이벤트명 확인

2-6 파이어스토어_오류_04

2. 오류가 발생한 이벤트로 이동 → 시스템 정보에서 컬렉션명이 정확히 입력되어 있는지 확인

2-6 파이어스토어_오류_05

 

3. 알아두면 좋은 정보 : 데이터를 수정, 삭제했는데 반영이 안돼요.

① 원인

  • 문서 아이디값(_docID)가 누락되었거나 알맞지 않은 경우

② 해결 방법

  1. 디버깅 로그에서 서비스 호출 시 보내는 데이터에 문서 아이디값(_docID)가 포함되어 있는지 확인
  2. 해당 값이 없다면 보내는 데이터의 로직 변경 필요 (예시 : 조회 혹은 저장 후 병합 등)

2-6 파이어스토어_오류_06

 

4. 알아두면 좋은 정보 : 데이터가 반영이 안돼요. 혹은 데이터가 있는데 조회가 안돼요.

① 원인

  • Firestore 컬렉션명이 알맞지 않은 경우

② 해결 방법

  • 시스템 정보의 Firestore 컬렉션명과 Firebase 콘솔의 컬렉션명과 일치하는지 확인

2-6 파이어스토어_오류_07

 

지금까지 플렉스튜디오에서 파이어스토어 연동 시 발생할 수 있는 오류와 그 해결 방법을 정리해 봤어요. 간단한 설정만으로도 많은 문제를 예방할 수 있으니 오류 발생 시 하나씩 점검해 보세요. 추가로 궁금한 점이 있다면 [플렉스튜디오 가이드]를 참고해 주세요!

 

 
사용 팁 로우코드 애플리케이션개발 파이어스토어 firestore

추천 블로그 콘텐츠