발급된 토큰을 서버에 저장하고 갱신 시각과 실패 응답을 이용해 오래된 등록을 정리하는 수명 주기를 설명합니다. 이 주제를 이해할 때 첫 기준은 ‘현재 등록값’입니다. 앱 시작과 onNewToken에서 얻은 값을 서버에 올리되 사용자 계정 하나에 토큰 하나만 있다고 가정하지 않습니다. 한 사용자가 여러 설치를 가질 수 있습니다.
이 글의 범위
실제 경험이나 측정 결과를 가정하지 않고, 공식 문서로 확인 가능한 개념과 적용 순서를 일반 가이드로 설명합니다. 제품 버전과 서비스 정책은 바뀔 수 있으므로 적용 전 연결된 공식 문서를 다시 확인하세요.
먼저 구분할 핵심
FCM 등록 정보는 발급되는 순간보다 그 뒤의 갱신, 계정 연결, 실패 분류가 중요합니다. ‘현재 등록값’에서 시작해 ‘갱신 시각’와의 경계를 정하면 구현할 범위와 실패했을 때 확인할 지점을 구분하기 쉬워집니다.
 |
| FCM 푸시 토큰의 갱신과 무효화를 관리하는 방법 핵심 판단 흐름 설명용 개념도 |
그림 1. FCM 푸시 토큰의 갱신과 무효화를 관리하는 방법의 핵심 판단 순서를 정리한 설명용 개념도입니다. 실제 서비스 화면, 운영 로그 또는 측정 결과가 아닙니다.
토큰을 한 번 쓰는 값이 아닌 상태로 관리하기
현재 등록값
앱 시작과 onNewToken에서 얻은 값을 서버에 올리되 사용자 계정 하나에 토큰 하나만 있다고 가정하지 않습니다. 한 사용자가 여러 설치를 가질 수 있습니다.
갱신 시각
토큰 또는 설치 식별자를 저장할 때 마지막 확인 시각을 함께 기록합니다. 값이 같아도 앱이 정상적으로 다시 연결됐다는 신호가 됩니다.
계정 연결
로그인·로그아웃 시 설치 등록과 사용자 대상 발송의 관계를 갱신합니다. 로그아웃한 기기에 이전 사용자의 민감한 알림이 가지 않게 합니다.
실패 응답
서버 발송 결과에서 등록되지 않은 토큰으로 확인되면 비활성화하거나 삭제합니다. 모든 실패를 같은 재시도 큐로 보내지 않습니다.
장기 미사용
오래 확인되지 않은 등록은 별도 정책으로 정리하고 발송 대상과 성과 지표에서 분리합니다. 기준은 서비스의 사용 주기에 맞춥니다.
클라이언트와 서버를 연결하는 순서
- 설치 단위 등록 레코드에 사용자, 현재 값, 플랫폼, 갱신 시각을 둡니다.
- 앱 시작과 토큰 변경 콜백에서 최신 값을 멱등하게 업로드합니다.
- 로그인·로그아웃 때 사용자 연결만 안전하게 갱신합니다.
- 발송 결과를 성공·일시 실패·영구 무효로 분류합니다.
- 장기 미사용과 영구 무효 등록을 정기적으로 정리합니다.
푸시 누락을 키우는 운영 패턴
- 최초 설치 때 받은 값만 영구 저장하기
- 사용자 ID를 토큰의 유일한 키로 사용하기
- 모든 발송 실패를 무제한 재시도하기
- 디버그 로그에 전체 토큰과 사용자 정보를 그대로 남기기
적용 전 마지막 점검
| 확인 항목 | 질문 |
|---|---|
| 첫 기준: 현재 등록값 | 변경 전에 전제와 목적을 확인했는가? |
| 분리 대상: 갱신 시각 | 다른 책임과 섞이지 않게 경계를 정했는가? |
| 피할 패턴: 최초 설치 때 받은 값만 영구 저장하기 | 본문에서 경고한 패턴이 남아 있지 않은가? |
| 오류와 복구 | 정상 경로뿐 아니라 실패와 되돌리기도 확인했는가? |
정리
FCM 등록 정보는 발급되는 순간보다 그 뒤의 갱신, 계정 연결, 실패 분류가 중요합니다. 설치 단위 레코드와 마지막 확인 시각을 관리하면 오래된 대상을 줄이고 실제 전달 상태를 더 정확히 해석할 수 있습니다.
