Сначала определите, что означает значок: число непрочитанных в вашем продукте или признак активных системных уведомлений. Затем сравните серверный остаток, локальный inbox и последнее применённое значение для иконки. Если после сброса приходит старый push со снимком счётчика, простое повторение команды «поставить ноль» скрывает гонку лишь до следующей доставки.
Одинаковый вид иконки не означает одинаковую модель
Apple предоставляет setBadgeCount для задания числа на иконке и сообщает ошибку выполнения. Android описывает notification dots как признак активных уведомлений в поддерживающем их launcher; это не универсальное отображение вашего серверного числа. Обе документации проверены 23 октября 2026 года. Поэтому тестировать нужно конкретную платформу и реализацию оболочки.
| Слой | Какой вопрос задать |
|---|---|
| Серверный inbox | Какие записи считаются непрочитанными |
| Локальное хранилище | Подтверждено ли чтение сервером |
| Push-снимок | Когда вычислено присланное число |
| Иконка iOS | Применено ли значение без ошибки |
| Android dot | Остались ли активные системные уведомления |
Не считайте прочтением сам запуск приложения, если продукт обещает число непрочитанных сообщений. Пользователь мог открыть другой раздел. Задайте точное событие: открытие конкретного сообщения, подтверждение «прочитать всё» или иной согласованный переход. Закрытие системной карточки и прочтение внутри продукта тоже могут иметь разные значения.
Разберите гонку на двух событиях
Условный сценарий:
ревизия 40: непрочитано 2, push поставлен в очередь
пользователь читает сообщения
ревизия 41: непрочитано 0, клиент подтверждает результат
приходит запоздалый снимок ревизии 40
ожидаемо: старый снимок не портит подтверждённое состояниеВыберите одного владельца расчёта остатка. Если сервер ведёт inbox, клиент отправляет подтверждение чтения и принимает согласованный результат, а не независимо вычитает единицу при каждом событии. Повторный callback или повторная доставка иначе легко дают отрицательный счётчик либо лишнее обнуление. Для оптимистичного интерфейса явно храните неподтверждённое действие и сверяйте его после ответа.
Добавление номера ревизии в собственную модель помогает клиентскому коду отбрасывать устаревшие ответы. Но оно само по себе не заставляет операционную систему сравнивать ревизии badge в payload. Если ОС применяет присланное число без участия вашего кода, это отдельный путь, который надо учесть при выборе стратегии отправки и последующей сверки. Не обещайте защиту от гонки одним новым полем JSON.
Чтение на втором устройстве меняет серверный остаток без локального клика на первом. Поэтому при возобновлении приложения полезна сверка inbox и производного индикатора. Если аккаунт сменился, предыдущий остаток не должен переходить новому пользователю. Это не повод удалять push-регистрации целиком: сначала установите, кто владеет числом и как привязано состояние.
Что должно остаться после чтения
- Повторное подтверждение чтения не уменьшает остаток второй раз.
- Чтение на другом устройстве отражается после сверки.
- Запоздалый ответ API не заменяет более новую ревизию.
- Системные карточки обрабатываются согласно правилам продукта.
- Ошибка обновления иконки видна в диагностике.
В режиме без сети показывайте последнее известное состояние честно. После восстановления связи сверяйте итог по данным inbox, не восстанавливайте его суммой всех когда-либо полученных push. Часть сигналов могла быть пропущена, объединена или повторена, поэтому поток уведомлений плохо подходит на роль единственного бухгалтерского журнала непрочитанного.
Для исправления достаточно искусственного inbox из двух записей, временной линии чтения и снимков числа с ревизиями. При откате меняйте способ обновления индикатора, сохраняя сами подтверждения чтения. Приёмка заканчивается согласованным остатком после всех задержанных событий, а не красивым нулём в одну выбранную секунду.