Ответ `BadDeviceToken` не означает, что APNs «лежит». Обычно сервер отправляет корректно сформированный запрос не в то окружение либо использует токен, выпущенный для другой сборки. Сохраните HTTP-статус, поле reason, `apns-id`, topic и выбранный endpoint — без этих полей разные причины выглядят одинаково.
Не пытайтесь лечить 4xx бесконечным retry. Для начала получите свежий токен на тестовом устройстве, передайте его backend без ручного копирования и сделайте одну отправку. Если она проходит, сравнивайте маршрут старого и нового токена. Если не проходит, проверяйте подпись провайдера, entitlement и topic.
Reason важнее общего текста ошибки
| Ответ APNs | Что проверять | Действие |
|---|---|---|
| 400 BadDeviceToken | Формат токена и соответствие development/production | Не повторять тот же запрос до исправления окружения |
| 400 DeviceTokenNotForTopic | Bundle ID и заголовок apns-topic | Исправить topic или выбрать токен нужного приложения |
| 410 Unregistered | Токен больше не активен для topic | Отключить токен с учётом timestamp ответа |
| 403 InvalidProviderToken | JWT, key ID, team ID и подпись | Обновить provider token, не заменяя device token наугад |
Ошибки device token и provider token относятся к разным уровням. Первая описывает адрес установки приложения, вторая — полномочия вашего сервера. Замена одного другим только стирает диагностический след.
Окружение определяется сборкой приложения
Значение entitlement `aps-environment` связывает сборку с development или production. Токен из отладочной сборки нельзя автоматически считать подходящим для production endpoint. TestFlight и релизные сборки тоже нужно проверять как отдельный маршрут, а не объединять с локальной разработкой одним флагом «iOS».
installation_id: 8f4c...
bundle_id: com.example.client
apns_environment: production
device_token_hash: 6d91...
last_registered_at: 2026-09-29T22:41:00+03:00
status: activeВ журнале достаточно хеша или короткого отпечатка токена. Полный адрес устройства храните в защищённом хранилище и не выводите в общий лог. Рядом полезно хранить installation_id, версию приложения, environment, topic и время последней регистрации.
Токен нужно принимать при каждой регистрации
Приложение запрашивает регистрацию у APNs при запуске и передаёт полученный токен вашему серверу. Не встраивайте предположение, что токен никогда не меняется. Переустановка, восстановление устройства и другие изменения жизненного цикла могут привести к новому адресу; backend должен обновить связь с конкретной установкой идемпотентно.
- Один пользователь может иметь несколько активных устройств и токенов.
- Выход из аккаунта должен отвязать установку от пользователя, а не удалить чужие устройства.
- Ответ 410 переводит адрес в неактивный, но сохраняет минимальный аудит причины.
- Новый токен для той же installation_id заменяет прежний адрес атомарно.
Контрольный тест без массовой рассылки
Соберите две тестовые сборки — development и production — и зарегистрируйте каждую как отдельную установку. Отправьте по одному сообщению через соответствующий endpoint и topic. Затем намеренно поменяйте окружение: ожидаемый результат — понятный 4xx, который попадает в лог и не запускает бесконечную очередь повторов.
После успешного ответа 200 проверяйте доставку отдельно. APNs принял запрос, но пользователь мог отключить показ уведомлений, устройство могло быть офлайн, а приложение — обработать тихое сообщение иначе. Не смешивайте ошибку адреса с последующим пользовательским поведением.
Материалы для технического разбора
Понадобятся HTTP-статус и reason, `apns-id`, environment, bundle ID, topic, способ авторизации и отпечаток токена. Private key, полный JWT и полный device token пересылать не нужно. Такой набор позволяет восстановить маршрут и не раскрывать рабочие секреты.