# 푸시 알림은 어떻게 작동할까: APNs와 FCM 설명

> 아이폰으로 가는 모든 푸시는 Apple의 APNs를 거치고, 안드로이드로 가는 거의 모든 푸시는 Google의 FCM을 거칩니다. 기기 토큰, 제공자 인증, 요청 자체, 기기가 오프라인일 때 일어나는 일, 그리고 플랫폼별로 우선순위가 실제로 어떻게 작동하는지 살펴봅니다.

*05.10.2026*

<!-- source: https://pocketalert.app/ko/blog/how-push-notifications-work-apns-fcm -->

푸시 알림은 밖에서 보면 단순합니다. 서버에서 무언가 일어나면 1초 뒤 휴대폰 화면이 켜집니다. 그 사이에는 Apple과 Google이 운영하는 두 개의 전송 네트워크가 있고, 푸시는 반드시 둘 중 하나를 거쳐 휴대폰에 도착합니다.

- **APNs**(Apple Push Notification service)는 아이폰, 아이패드, 맥, Apple Watch로 가는 모든 푸시를 전달합니다.
- **FCM**(Firebase Cloud Messaging)은 Google Play 서비스가 설치된 안드로이드 기기로 푸시를 전달하며, APNs에 메시지를 넘겨 iOS로 보낼 수도 있습니다.

이 가이드는 알림 하나가 서버에서 두 플랫폼의 잠금 화면까지 가는 과정을 따라가며, 실제 운영 환경에서 실행해 보기 전에는 드러나지 않는 세부 사항도 함께 다룹니다. 저희는 [Pocket Alert](/) 뒤에서 두 파이프라인을 모두 운영하고 있으므로, 여기 나오는 예시는 실제로 배포하는 코드에서 가져왔습니다.

## 네 주체

1. **사용자의 서버**입니다. Apple은 이를 제공자(provider)라고 부릅니다. 무언가를 보내야 한다고 판단합니다.
2. **푸시 서비스**, 즉 APNs 또는 FCM입니다. 요청을 받아 경로를 정합니다.
3. **기기**입니다. 운영체제는 Apple 또는 Google과 하나의 장기 암호화 연결을 유지하고, 모든 앱의 푸시를 이 연결을 통해 받습니다.
4. **앱**입니다. 알림을 등록했고, 푸시가 향하는 토큰을 소유합니다.

세 번째 주체 덕분에 푸시는 배터리를 적게 씁니다. 휴대폰은 서버에 주기적으로 물어보지 않습니다. 모든 앱이 공유하는 연결 하나가 계속 열려 있고, 전달할 내용이 생기면 푸시 서비스가 그 연결로 보냅니다.

## 1단계: 기기가 토큰을 받습니다

앱이 원격 알림을 등록하면 운영체제는 토큰을 건넵니다. 토큰은 "이 기기의 이 앱"을 가리키는 불투명한 주소입니다. 앱은 이 토큰을 서버로 보내고, 서버는 이를 저장합니다.

- **APNs 기기 토큰**은 앱과 기기의 조합마다 고유합니다. Apple은 앱에 토큰을 캐시하지 말라고 권장합니다. 사용자가 백업에서 복원하거나, 새 기기로 옮기거나, 운영체제를 재설치하면 토큰이 바뀌기 때문입니다.
- **FCM 등록 토큰**은 안드로이드에서 같은 역할을 하며, FCM은 자체 일정에 따라 이를 새로 고칩니다.

토큰은 수시로 오래된 상태가 됩니다. 저장된 토큰을 최신으로 유지하는 것이 푸시 운영에서 가장 큰 부분 중 하나입니다.

## 2단계: 서버가 자신을 증명합니다

### APNs

APNs는 TLS 1.2 이상 위에서 HTTP/2를 사용합니다. 운영 환경은 `api.push.apple.com`, 개발 빌드는 `api.sandbox.push.apple.com`이며, 포트는 443 또는 2197입니다. 인증 방식은 두 가지입니다.

- **토큰 기반.** Apple 개발자 계정에서 `.p8` 서명 키를 만든 뒤, ES256으로 짧은 JWT에 서명합니다. 이 JWT에는 Team ID와 키 ID가 들어갑니다. Apple은 JWT를 20분에 한 번보다 자주 갱신하지 말고, 60분에 한 번보다 드물게 갱신하지 말라고 요구합니다. 오래된 JWT를 보내면 `403 ExpiredProviderToken`이 돌아오고, 너무 자주 갱신하면 `429 TooManyProviderTokenUpdates`가 돌아옵니다.
- **인증서 기반.** 앱마다 TLS 클라이언트 인증서를 하나씩 쓰며, 유효 기간은 1년이고 이후에는 갱신해야 합니다.

토큰 인증을 사용하세요. 키 하나로 모든 앱을 처리할 수 있고, 매년 만료되지도 않습니다.

### FCM

FCM의 HTTP v1 API는 Google 서비스 계정에서 발급받은 단기 OAuth 2.0 액세스 토큰을 요구하며, `firebase.messaging` 범위를 사용합니다. 정적 서버 키를 쓰던 이전 "레거시" API는 2023년에 지원 중단이 발표되었고 2024년 7월부터 종료되었습니다. 그래서 여전히 `Authorization: key=...`로 보내는 코드는 더 이상 동작하지 않습니다.

## 3단계: 요청

### APNs로 보내기

각 푸시는 `/3/device/<device token>` 경로로 가는 HTTP/2 POST 요청입니다. 처리 방식을 바꾸는 몇 가지 헤더가 함께 붙습니다.

```bash
curl --http2 \
  -H "authorization: bearer $APNS_JWT" \
  -H "apns-topic: com.example.alerts" \
  -H "apns-push-type: alert" \
  -H "apns-priority: 10" \
  -d '{"aps": {"alert": {"title": "Backup failed", "body": "db-01: pg_dump exited with code 1"}, "sound": "default", "interruption-level": "time-sensitive"}}' \
  "https://api.push.apple.com/3/device/$DEVICE_TOKEN"
```

- `apns-topic`은 앱의 번들 ID입니다.
- `apns-push-type`은 푸시의 종류를 지정합니다. 화면에 보이는 알림은 `alert`, 소리 없는 데이터 푸시는 `background`이며, 그 밖에도 몇 가지 값이 있습니다.
- `apns-priority`는 지금 바로 전달하려면 `10`, 기기의 전원 상태에 맡기려면 `5`, 전력을 아끼고 기기를 깨우지 않으려면 `1`입니다.
- `apns-expiration`은 APNs가 재시도를 얼마나 계속할지 정합니다. `0`이면 한 번만 시도하고 저장하지 않습니다.
- `apns-collapse-id`는 같은 id를 가진 새 알림이 이전 알림을 대체하게 합니다.

페이로드는 `aps` 사전을 담은 JSON이며, 크기 상한은 **4KB**(VoIP는 5KB)입니다.

### FCM으로 보내기

FCM은 요청 하나에 JSON 메시지 하나를 받습니다.

```bash
curl -X POST "https://fcm.googleapis.com/v1/projects/$PROJECT_ID/messages:send" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "message": {
      "token": "DEVICE_REGISTRATION_TOKEN",
      "notification": { "title": "Backup failed", "body": "db-01: pg_dump exited with code 1" },
      "android": { "priority": "high", "notification": { "channel_id": "alerts_high" } }
    }
  }'
```

`notification` 메시지는 앱이 백그라운드에 있을 때 시스템이 직접 표시합니다. `data` 메시지는 앱에 전달되어 앱이 처리합니다. 어느 쪽이든 페이로드 제한은 **4,096바이트**입니다.

## 4단계: 전달, 또는 전달을 기다리는 시간

휴대폰이 온라인이면 푸시는 열린 연결을 타고 곧바로 도착합니다. 오프라인이라면 다음과 같습니다.

- **APNs**는 `apns-expiration`에 따라 최대 30일까지 알림을 보관하지만, 앱당 기기당 **알림 하나만** 보관합니다. 휴대폰이 비행기 모드일 때 다섯 개를 보내면 보통 마지막 것 하나만 받게 됩니다. Apple은 그것이 가장 최신 알림이라는 것조차 보장하지 않습니다.
- **FCM**은 메시지를 유효 기간(TTL)만큼 보관합니다. 기본값은 4주이며 최대 28일입니다. 병합 가능한 메시지는 서로를 대체하며, 기기당 최대 4개의 병합 키를 쓸 수 있습니다.

우선순위는 전달 시점에도 영향을 줍니다. iOS에서는 우선순위 `5`와 `1` 푸시가 묶이거나, 속도가 제한되거나, 버려질 수 있습니다. 안드로이드에서는 `normal` 우선순위 메시지가 기기가 Doze 상태를 벗어날 때까지 기다릴 수 있고, `high` 우선순위 메시지는 즉시 전달됩니다. FCM은 이 특권을 어떻게 쓰는지도 지켜봅니다. 화면에 아무 알림도 표시하지 않는 높은 우선순위 메시지는 시간이 지나면서 조용히 일반 우선순위로 낮춰질 수 있습니다.

## 알림이 얼마나 크게 울리는지: 중요도 수준과 채널

전달은 한 가지 문제이고, 휴대폰에서 소리가 나는지는 또 다른 문제입니다. 두 플랫폼은 이를 다르게 처리합니다.

**iOS**(15 이상)는 알림마다 중요도 수준(interruption level)을 지정합니다.

- `passive`는 화면을 켜거나 소리를 내지 않고 목록에만 추가합니다.
- `active`가 기본값입니다.
- `time-sensitive`는 집중 모드와 알림 요약을 뚫고 나올 수 있습니다. 사용자는 앱별로 이 기능을 끌 수 있습니다.
- `critical`은 방해 금지 모드와 무음 스위치가 켜져 있어도 항상 재생됩니다. 이를 쓰려면 Apple이 심사 후 요청에 따라 승인하는 권한(entitlement)이 필요합니다.

**안드로이드**(8 이상)는 모든 알림을 **채널**에 넣고, 채널이 중요도를 결정합니다. 소리, 진동, 헤즈업 표시, 방해 금지 모드에서의 동작이 모두 채널 설정입니다. 앱이 채널을 만들지만, 채널이 한 번 생기면 그 동작은 사용자의 몫이 됩니다. 앱은 나중에 이를 바꿀 수 없습니다.

이 마지막 규칙은 실제로 영향을 줍니다. Pocket Alert의 치명적 경고를 무음 모드에서도 울리게 만들었을 때, 기존 critical 채널은 사후에 알람 오디오로 바꿀 수 없었습니다. 해결책은 새 id를 가진 두 번째 채널을 만드는 것이었습니다. 서버는 이 채널을 만든 앱 빌드에만 이를 선택합니다. 앱이 만든 적 없는 채널로 보내면 알림이 아예 표시되지 않기 때문입니다.

Android 13 이상에서는 관문이 하나 더 있습니다. 앱에 `POST_NOTIFICATIONS` 런타임 권한이 필요하며, 새로 설치한 경우 사용자가 허용하기 전까지 알림은 꺼져 있습니다.

## 운영 환경에서 생기는 문제들

- **오래된 토큰.** APNs는 더 이상 유효하지 않은 토큰에 `410 Unregistered`를 응답합니다. 그 토큰으로 보내는 것을 멈추고 삭제하세요.
- **잘못된 환경.** 개발 빌드의 토큰을 운영 호스트로 보내면 `400 BadDeviceToken`으로 실패합니다.
- **지나치게 큰 페이로드.** 4KB를 넘으면 `413 PayloadTooLarge`가 돌아옵니다. 알림 본문에 긴 로그 줄을 넣는 것이 흔한 원인입니다.
- **낮춰진 우선순위.** 아무것도 표시하지 못한 높은 우선순위 안드로이드 메시지는 우선순위를 잃습니다.
- **알림 꺼짐.** 푸시는 전달되었지만 사용자는 보지 못합니다. 권한을 거부했거나 채널을 음소거했기 때문입니다.

## 지름길

이 모든 것을 직접 구축할 가치가 있는 경우는 앱이 여러분의 제품이고 그 사용자에게 보내야 할 때입니다. 자신이나 팀에게 보내는 경고라면 이는 지나치게 큰 인프라입니다. 플랫폼마다 개발자 계정이 필요하고, 서명 키, 토큰 저장소, 두 가지 요청 형식, 두 가지 우선순위 모델을 관리해야 합니다.

푸시 알림 서비스는 두 파이프라인을 대신 운영해 줍니다. Pocket Alert를 쓰면 자신의 토큰이나 인증서 없이 요청 하나만 보내면 됩니다.

```bash
curl -X POST https://api.pocketalert.app/v1/messages \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"title": "Backup failed", "message": "db-01: pg_dump exited with code 1", "level": "high"}'
```

`level` 필드는 플랫폼마다 다음과 같이 변환됩니다.

- `silent`는 아이폰에서 소리 없는 passive 알림이며, 안드로이드에서는 무음 채널로 갑니다.
- `low`는 아이폰에서 passive이고, 안드로이드에서는 낮은 중요도입니다.
- `default`는 두 플랫폼 모두에서 일반 알림입니다.
- `high`는 아이폰에서 time-sensitive이고, 안드로이드에서는 높은 우선순위입니다.
- `critical`은 안드로이드에서 방해 금지 모드를 무시합니다. 아이폰에서는 time-sensitive로 도착하며, Apple이 권한을 승인함에 따라 전체 치명적 경고 소리를 순차적으로 도입하고 있습니다.

이에 대해서는 [치명적 경고](/use-cases/critical-alerts)에서 더 자세히 다루고, API 자체는 [푸시 알림 API란 무엇인가](/blog/what-is-a-push-notification-api)에서 확인할 수 있습니다.

## FAQ

### APNs는 전달을 보장하나요?

아니요. APNs와 FCM은 모두 최선 노력(best-effort) 방식입니다. APNs는 오프라인 기기에 대해 가장 최신 알림 하나만 저장하며, 두 서비스 모두 메시지가 언제 도착할지 보장하지 않습니다. Google 문서는 한 걸음 더 나아가 FCM을 생명에 관련된 긴급 경고에 쓰면 안 된다고 명시합니다. 온콜 호출에서는 푸시를 가장 빠른 채널로 보되, 유일한 채널로 여기지 마세요.

### APNs와 FCM을 둘 다 써야 하나요?

아이폰은 APNs를 통해서만 푸시를 받습니다. Google Play 서비스가 있는 안드로이드 기기는 FCM으로 받습니다. 사용자가 두 플랫폼을 모두 쓴다면 서버는 두 곳과 모두 통신해야 합니다. 직접 보내거나, FCM을 거쳐 APNs로 전달되도록 할 수 있습니다.

### FCM으로 아이폰에 알림을 보낼 수 있나요?

네. APNs 인증 키를 Firebase에 업로드하면 FCM이 메시지를 APNs에 넘겨 iOS로 전달합니다. Apple 기기로 보내는 데이터 메시지는 일반 우선순위로 보내야 합니다.

### 푸시 알림은 얼마나 클 수 있나요?

APNs 페이로드는 4KB(VoIP 푸시는 5KB), FCM 메시지는 4,096바이트입니다. 긴 텍스트는 푸시가 아니라 앱이나 링크에 담으세요.

### 기기 토큰이란 무엇인가요?

Apple 또는 Google이 발급하는, 기기 한 대의 앱 하나를 가리키는 주소입니다. 서버는 이 주소로 푸시를 보냅니다. 토큰은 언제든 바뀔 수 있으므로, 서버는 갱신된 토큰을 받아들이고 APNs나 FCM이 무효하다고 알려온 토큰은 버려야 합니다.

[무료 Pocket Alert 계정을 만들고](/signup) 키와 토큰 관리를 건너뛰거나, [대안](/alternatives)에서 다른 서비스와 비교해 보세요.
