[Android] FCM 수신 백그라운드 작업 WorkManager로 안전하게 분리하기 (실무 적용 코드)
앱을 개발하고 운영하다 보면 FCM(Firebase Cloud Messaging)을 연동할 일이 참 많습니다. 푸시 메시지가 올 때 단순히 알림만 띄우면 상관없는데, 메시지를 신호탄 삼아 서버에서 상세 데이터를 다시 긁어오거나 로컬 DB를 동기화해야 하는 경우가 꼭 생기더군요. 저의 경우도 처음에는 FirebaseMessagingService.onMessageReceived() 안에서 가볍게 네트워크 요청을 보냈다가, 앱이 백그라운드에 있을 때 작업이 툭 끊기거나 실패 시 재시도가 안 돼서 골치를 썩은 적이 있습니다. 자꾸 까먹기도 하고, 실무에서 실수하기 쉬운 부분이라 정돈해서 기록해 둡니다. 1. 운영하다 보면 자주 하는 실수 (내가 겪은 상황) FCM 수신 처리에서 문제가 생기는 코드는 보통 아래와 같은 상황을 간과할 때 발생합니다. onMessageReceived() 안에서 긴 네트워크 요청(API 호출)을 바로 실행함 실패하면 다시 시도해야 하는 작업을 일회성 처리로 대충 끝냄 앱이 백그라운드 상태일 때 OS 제약으로 작업이 중간에 강제 종료되는 상황을 고려 안 함 넘어온 data payload를 검증하지 않고 그대로 Worker 인풋으로 넘김 로그에 FCM 토큰, 서버 URL, 사용자 식별자(ID)를 그대로 남겨 보안 필터에 걸림 알림을 표시하는 UI 책임과 데이터 동기화 책임을 한 함수에서 모두 처리함 운영 관점에서는 FCM 수신 콜백을 "모든 작업을 수행하는 시작점"이 아니라, "작업을 분류하고 안전한 곳으로 위임하는 진입점"으로 보는 것이 좋습니다. 2. 해결 방법: 즉시 처리와 위임 처리 나누기 작업 성격에 따라 FCM 콜백에서 바로 끝낼지, WorkManager 로 넘길지 확실히 나눠야 유지보수가 편합니다. 제가 실무에서 잡은 기준은 이렇습니다. 작업 종류 처리 위치 이유 단순 알림 표시 onMessageReceived() 짧고 즉시 끝나는 작업입니다. payload 데이터 검증 onMessageRec...