# FCM Token 기반 푸시 알림 구현 (Expo + Spring Boot For Android)

React Native(Expo) 앱에서 푸시 알림을 구현하려면
Firebase Cloud Messaging(FCM) 을 사용하는 것이 가장 안정적인 구조다.
여기서는 ExpoPushToken이 아닌 FCM Token 기반으로 푸시를 구현하는 전체 흐름을 정리한다.

---

1. Firebase 기본 설정

1) Firebase 프로젝트 생성

https://firebase.google.com/

Firebase | Google's Mobile and Web App Development Platform

Firebase Console → 새 프로젝트 생성

필요한 기능:

• Cloud Messaging
• Firebase Admin SDK (백엔드)

---

2) Android 설정

Android 앱 추가 → 패키지명 입력
경로 예시:

com.appname.app

이후 제공되는 파일을 다운로드:

google-services.json

Expo(EAS)에서는 다음처럼 app.json 또는 app.config.js에 등록해준다:

{
  "expo": {
    "android": {
      "googleServicesFile": "./google-services.json"
    }
  }
}

---

2. FCM Token 가져오기 (Expo 앱)

Expo Go에서는 FCM Token이 생성되지 않기 때문에
반드시 EAS Build로 만든 독립 앱에서 테스트해야 한다.

앱에서 토큰을 가져오는 API:

import * as Notifications from "expo-notifications";

const tokenInfo = await Notifications.getDevicePushTokenAsync();
const fcmToken = tokenInfo.data;

이렇게 받아온 FCM Token을 백엔드에 저장해야 한다.

---

3. 백엔드(Firebase Admin SDK) 설정

1) Admin SDK 설치

Firebase Console
→ 프로젝트 설정
→ 서비스 계정
→ “새 비공개 키 생성”

파일명 예:

bimong-firebase-adminsdk-xxxx.json

Spring Boot 리소스 폴더 또는 Docker 컨테이너 내에 넣은 후
application.properties에서 경로 설정:

firebase.service-account=/app/config/firebase-service-account.json

---

3) FirebaseApp 초기화

@Configuration
public class FirebaseConfig {

    @Value("${firebase.service-account}")
    private String serviceAccountPath;

    @PostConstruct
    public void init() throws IOException {
        FileInputStream serviceAccount = new FileInputStream(serviceAccountPath);

        FirebaseOptions options = FirebaseOptions.builder()
                .setCredentials(GoogleCredentials.fromStream(serviceAccount))
                .build();

        if (FirebaseApp.getApps().isEmpty()) {
            FirebaseApp.initializeApp(options);
        }
    }
}

---

4. 백엔드에서 FCM으로 푸시 보내기

1) 메시지 DTO

public class PushMessageDTO {
    private String token;
    private String title;
    private String body;
}

2) 메시지 전송 서비스

@Service
public class FcmService {

    public void sendMessage(PushMessageDTO dto) throws Exception {

        Message message = Message.builder()
                .setToken(dto.getToken())
                .setNotification(
                        Notification.builder()
                                .setTitle(dto.getTitle())
                                .setBody(dto.getBody())
                                .build()
                )
                .build();

        String response = FirebaseMessaging.getInstance().send(message);
        System.out.println("FCM 응답: " + response);
    }
}

FirebaseMessaging은 FCM v1 API 기반으로 작동한다.

---

5. 실제 동작 흐름

1. 앱 실행 → FCM Token 발급
2. 앱이 토큰을 백엔드로 전송
3. 백엔드 DB에 deviceId + fcmToken 저장
4. 스케줄러나 특정 비즈니스 로직에서 fcmToken 조회
5. Firebase Admin SDK → FCM 서버에 메시지 전송
6. FCM 서버 → 기기(iOS/Android)로 알림 전달
7. 앱이 백그라운드/꺼진 상태여도 알림 수신

---

6. 정리

푸시가 정상적으로 동작하려면:

1. Firebase Cloud Messaging 설정
2. google-services.json / plist 포함된 EAS 앱 빌드
3. 앱에서 FCM Token 발급
4. 백엔드에 저장
5. 백엔드에서 Firebase Admin SDK로 푸시

이 구조가 완성돼야 기기에서 푸시가 정상 동작한다