Диагностика push-уведомлений
Обновлено: 2 сентября 2026
Если при работе Push-канала возникают ошибки, перед обращением в службу поддержки edna подготовьте информацию, приведённую ниже.
Общая информация для предоставления
- App Package или APNS Topic приложения;
- операционная система и версия устройства;
- версия библиотеки edna SDK;
- информация о новой интеграции или переходе с предыдущей версии;
- используемая среда (тестовая или промышленная);
- частота возникновения проблемы;
- количество затронутых устройств;
- возможность воспроизведения проблемы на тестовом устройстве;
- возможность собрать логи с устройства;
- состояние приложения при получении уведомления (открыто, свернуто или выгружено);
- тип push-уведомления (длинное или короткое);
- идентификатор сообщения из
OUT_MESSAGES_TAB.
Для Android-приложений
Для диагностики приложите:
AndroidManifest.xml;- код интеграции SDK edna;
- файлы
build.gradleпроекта и приложения; - файл конфигурации ProGuard (если используется).
По возможности также укажите:
- используется ли стандартная или кастомная отрисовка уведомлений;
- используются ли кастомные worker-компоненты;
- результат выполнения worker при регистрации устройства;
- статус получения push-токена (получен, не получен или получен без адреса).
Для iOS-приложений
Для диагностики приложите:
- код интеграции SDK из
AppDelegateиNotificationService; - скриншоты вкладки Signing & Capabilities для основного приложения и расширения;
- файлы
Info.plistдля приложения и расширения.
Что приложить к обращению
Для ускорения диагностики приложите:
- логи с отметкой времени (
timestamp), соответствующей моменту возникновения ошибки; - пример
payloadпроблемного push-уведомления; - идентификатор сообщения (
messageId), если он известен; - любую дополнительную информацию, которая поможет воспроизвести проблему.
Справочник ошибок
Ошибки APNS (Apple Push Notification service)
| Ошибка | Описание |
|---|---|
apns-error: application-removed (Unregistered) | Приложение удалено с устройства |
apns-error: pns-access-error (connect timed out) | Ошибка облачного сервиса |
apns-error: pns-access-error (DeviceTokenNotForTopic) | Неверная настройка приложения |
apns-error: pns-access-error (timeout) | Ошибка облачного сервиса |
apns-error: expired-before-pushing | Срок действия сообщения истек перед отправкой |
apns-error: pns-access-error (BadDeviceToken) | Отправка в неверное облако |
apns-error: pns-access-error (SSL peer shut down incorrectly) | Проблема с валидным сертификатом |
apns-error: pns-access-error (Connection reset) | Ошибка облачного сервиса |
apns-error: pns-access-error (certificate_expired) | Истек срок действия сертификата |
apns-error: pns-access-error (certificate_revoked) | Сертификат отозван |
Ошибки FCM (Firebase Cloud Messaging)
| Ошибка | Описание |
|---|---|
gcm-error: application-removed (device-unregistered) | Приложение удалено с устройства |
gcm-error: bad-registration | Неверный адрес устройства в облаке |
gcm-error: invalid-json | Ошибка облачного сервиса |
gcm-error: No sender for [acnId:**;devUid:****] found | Неверная настройка приложения |
gcm-error: pns-access-error (Forbidden character) | Запрещённый символ |
gcm-error: sender-id-mismatch | Неверная настройка приложения |
Ошибки Huawei Push Kit
| Ошибка | Описание |
|---|---|
hcm-error: application-removed (All the tokens are invalid) | Приложение удалено с устройства |
hcm-error: expired-before-pushing | Срок действия сообщения истёк перед отправкой |
hcm-error: pns-access-error (invalid client_secret) | Неверная настройка приложения |
Ошибки RuStore Push
| Ошибка | Описание |
|---|---|
rcm-error: pns-access-error (INVALID_ARGUMENT) | Невалидный push-токен |
rcm-error: pns-access-error (NOT_FOUND) | Токен просрочен или использован ID другого проекта |
gcm-error: No sender for [acnId:**;devUid:****] found | Неверная настройка приложения |
Ошибки Web API
| Ошибка | Описание |
|---|---|
webapi-error: pns-access-error (no protocol: null) | Неверный адрес endpoint=null |
webapi-error: application-removed (404: ) | Неверный endPoint |
webapi-error: pns-access-error (Invalid point encoding 0x-39) | Неверные данные в разделе keys |
webapi-error: pns-access-error (Unrecognized token 'j'...) | Неверный pnsPushAddress |