❗ [버그][로그인] 로그인이 안되는문제 fcm json 수정 필요

[Cassiiopeia]

🗒️ 설명

• 현재 fcm token json이 포함된 파일을 빌드과정에서 추가안하고 있는것같습니다
• 기기에서 로그인이 되지않으며 json 요청조차 오지않습니다 확인이 필요합니다

🔄 재현 방법

1. 기기에서 로그인
2. 백엔드에서도아무런 로그가 뜨지않음

📸 참고 자료

✅ 예상 동작

• 예: 버튼을 클릭하면 새로운 페이지로 이동해야 함
• 예: 입력한 데이터가 저장되고 정상적으로 화면에 표시되어야 함

⚙️ 환경 정보

• OS:
• 브라우저:
• 기기:

🙋‍♂️ 담당자

• 백엔드: @Cassiiopeia
• 프론트엔드: 이름
• 디자인: 이름

[Cassiiopeia]

Guide by SUH-LAB

브랜치

20260210_#24_로그인이_안되는문제_fcm_json_수정_필요

커밋 메시지

로그인이 안되는문제 fcm json 수정 필요 : feat : {변경 사항에 대한 설명} https://github.com/MapSee-Lab/MapSy-BE/issues/24

[Cassiiopeia]

📌 작업 개요

Firebase Service Account JSON 파일(mapsy-fcm.json)이 CI/CD 파이프라인에서 생성되지 않아 배포 시 FCM 푸시 알림이 동작하지 않는 문제 해결. 3개 워크플로우에 Firebase JSON 생성 스텝 추가.

🔍 문제 분석

• application.yml에서 firebase.credentials.path: mapsy-fcm.json으로 Firebase 인증 파일 참조
• FirebaseConfig.java가 ClassPathResource로 classpath에서 해당 파일을 로드
• .gitignore에 *-fcm.json, mapsy-fcm.json 등록되어 Git에 포함되지 않음
• CI/CD 워크플로우에 해당 파일을 생성하는 스텝이 존재하지 않음 → 배포 시 파일 누락
• PR-PREVIEW 워크플로우에는 Firebase 생성 스텝이 주석 처리된 상태로 존재했으나, 경로가 Suh-Web (다른 프로젝트) 기준이라 활성화해도 동작하지 않는 상태

추가로 기존 로컬 mapsy-fcm.json이 tripgether-55abb 프로젝트 키로 설정되어 있어, 올바른 mapsy-40e92 프로젝트 키로 교체 필요.

✅ 구현 내용

1. 메인 배포 워크플로우 - Firebase JSON 생성 스텝 추가

• 파일: .github/workflows/PROJECT-SPRING-SYNOLOGY-MAPSEE-CICD.yaml
• 변경 내용: application-prod.yml 생성 직후(step 4-1)에 mapsy-fcm.json 생성 스텝 추가
• 생성 경로: ${{ env.APPLICATION_YML_DIR }}/mapsy-fcm.json → MS-Web/src/main/resources/mapsy-fcm.json
• 방식: secrets.FIREBASE_KEY_JSON을 heredoc(cat << 'EOF')으로 파일 생성

2. 심플 배포 워크플로우 - Firebase JSON 생성 스텝 추가

• 파일: .github/workflows/PROJECT-SPRING-SYNOLOGY-SIMPLE-CICD.yaml
• 변경 내용: application-prod.yml 생성 직후(step 4-1)에 mapsy-fcm.json 생성 스텝 추가
• 생성 경로: src/main/resources/mapsy-fcm.json (심플 워크플로우 경로 규칙 준수)
• 방식: 동일 heredoc 방식

3. PR Preview 워크플로우 - Firebase JSON 생성 스텝 추가 (2곳)

• 파일: .github/workflows/PROJECT-SPRING-SYNOLOGY-PR-PREVIEW.yaml
• 변경 내용:
  • PR 빌드 Job (build-preview-pr): 기존 주석 처리된 Firebase 스텝을 삭제하고, 올바른 경로의 활성 스텝으로 교체
  • Issue 빌드 Job (build-preview-issue): application-prod.yml 생성 직후에 Firebase JSON 생성 스텝 추가 (if: steps.check_branch.outputs.exists == 'true' 조건 포함)
• 생성 경로: MS-Web/src/main/resources/mapsy-fcm.json
• 추가 변경: Secrets 가이드 주석에서 FIREBASE_KEY_JSON을 [선택]에서 [필수]로 변경

🔧 주요 변경사항 상세

추가된 스텝 (공통 패턴)

- name: mapsy-fcm.json 생성 (Firebase)
  run: |
    cat << 'EOF' > ./MS-Web/src/main/resources/mapsy-fcm.json
    ${{ secrets.FIREBASE_KEY_JSON }}
    EOF

application-prod.yml 생성과 동일한 heredoc 방식 사용. GitHub Secret에 JSON 전체 내용을 저장하고, CI/CD에서 파일로 생성하는 패턴.

특이사항:

• 기존 PR-PREVIEW에 주석으로 있던 Firebase 스텝은 sed 방식(echo | sed 's/\\n/\n/g')이었으나, 다른 스텝과 일관성을 위해 heredoc 방식으로 통일
• 기존 주석의 경로가 Suh-Web/src/main/resources/firebase-admin-sdk.json(다른 프로젝트 기준)이었으므로, MS-Web/src/main/resources/mapsy-fcm.json으로 수정

변경 파일 요약

워크플로우	추가 위치	조건
MAPSEE-CICD.yaml	step 4-1 (Gradle 빌드 전)	없음 (항상 실행)
SIMPLE-CICD.yaml	step 4-1 (Gradle 빌드 전)	없음 (항상 실행)
PR-PREVIEW.yaml (PR 빌드)	[영역 2] Secret 파일 생성 구간	없음
PR-PREVIEW.yaml (Issue 빌드)	[영역 2] Secret 파일 생성 구간	steps.check_branch.outputs.exists == 'true'

🧪 테스트 및 검증

• GitHub Secrets에 FIREBASE_KEY_JSON 등록 (mapsy-40e92 프로젝트 Service Account JSON 전체 내용)
• deploy 브랜치 push 후 MAPSEE-CICD 워크플로우 정상 실행 확인
• 배포된 컨테이너에서 Firebase Admin SDK 초기화 로그 확인: ✅ Firebase Admin SDK 초기화 완료
• FCM 푸시 알림 정상 동작 확인

📌 참고사항

• GitHub Secret 등록 필수: FIREBASE_KEY_JSON에 mapsy-40e92-firebase-adminsdk-fbsvc-{HASH}.json 파일 전체 내용을 복붙해야 함
• 로컬 mapsy-fcm.json 교체 필요: 현재 로컬 파일이 tripgether-55abb 프로젝트 키로 되어 있어, mapsy-40e92 키로 교체 필요
• .gitignore에 *-fcm.json과 mapsy-fcm.json이 등록되어 있어 로컬 파일은 Git에 포함되지 않음

[Cassiiopeia]

Stable 반영완료 완료 처리합니다