Ответ `BadDeviceToken` не означает, что APNs «лежит». Обычно сервер отправляет корректно сформированный запрос не в то окружение либо использует токен, выпущенный для другой сборки. Сохраните HTTP-статус, поле reason, `apns-id`, topic и выбранный endpoint — без этих полей разные причины выглядят одинаково.

Не пытайтесь лечить 4xx бесконечным retry. Для начала получите свежий токен на тестовом устройстве, передайте его backend без ручного копирования и сделайте одну отправку. Если она проходит, сравнивайте маршрут старого и нового токена. Если не проходит, проверяйте подпись провайдера, entitlement и topic.

Reason важнее общего текста ошибки

Ответ APNsЧто проверятьДействие
400 BadDeviceTokenФормат токена и соответствие development/productionНе повторять тот же запрос до исправления окружения
400 DeviceTokenNotForTopicBundle ID и заголовок apns-topicИсправить topic или выбрать токен нужного приложения
410 UnregisteredТокен больше не активен для topicОтключить токен с учётом timestamp ответа
403 InvalidProviderTokenJWT, 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 пересылать не нужно. Такой набор позволяет восстановить маршрут и не раскрывать рабочие секреты.

Проверенные источники