Отписка должна остановить две вещи: выбор endpoint на вашем сервере и подписку браузера у push service. Если кнопка меняет только локальный переключатель, фоновая рассылка продолжает брать старую строку из базы. Начните с server-side disable — он прекращает новые отправки даже при сбое браузерного unsubscribe.

Не тестируйте массовой рассылкой. Создайте отдельную подписку, сохраните hash endpoint, отправьте одно сообщение, откажитесь от уведомлений и повторите через тот же диагностический job. Полный endpoint и ключи подписки в обычный лог не выводятся: они позволяют адресовать браузер.

Одинаковый симптом оставляет разные следы

НаблюдениеВероятная причинаСледующая проверка
Send job создан после opt-outBackend не фильтрует active=falseЗапрос отбора получателей
Job старше opt-outСообщение уже было принято push servicecreated_at и TTL
Другой endpoint hashВторой профиль или старая подпискаСписок endpoint устройства/аккаунта
Один push показан дваждыДва обработчика showNotificationЛог service worker и tag
Отписка пропала после reloadUI не читает фактическое состояниеgetSubscription и серверный статус

Разница во времени принципиальна: кнопка не может отозвать уже показанное уведомление. Для сообщения, принятого сервисом до отказа, результат зависит от состояния подписки и срока хранения. Поэтому журнал связывает opt_out_at, queued_at и ответ отправки, а не ограничивается фразой «пришло после».

Один endpoint получает явное состояние

POST /push/subscriptions/disable { endpoint_hash, revision }
server: active=false, disabled_reason="user_opt_out", disabled_at=now()

subscription = await registration.pushManager.getSubscription()
if (subscription) await subscription.unsubscribe()

sender query: WHERE active=true AND consent_revision=current
terminal push response: disable endpoint, do not retry forever

Метод unsubscribe возвращает Promise с результатом попытки деактивации подписки в пользовательском агенте. Он не является командой вашему приложению удалить строку в базе. Серверная операция должна быть идемпотентной: повторное нажатие сохраняет то же disabled_at или новую ревизию, но не оживляет endpoint.

Порядок действий переживает обрыв сети

  1. UI блокирует переключатель и отправляет серверный disable.
  2. Backend перестаёт выбирать endpoint для новых рассылок.
  3. Браузер получает текущую PushSubscription и вызывает unsubscribe.
  4. Клиент показывает подтверждение только после понятного результата обоих шагов.
  5. Неоконченный browser step можно повторить, не меняя server-side отказ.
  6. Новая подписка создаётся только после нового осознанного согласия.

Если сеть исчезла сразу после server disable, пользователь уже защищён от новых отправок вашего приложения. Если первым выполнить только unsubscribe, а запрос к вашему серверу потеряется, база продолжит планировать доставки на недействительный адрес и засорять повторные очереди.

Аккаунт и браузер не равны одной подписке

  • Один аккаунт может иметь несколько устройств и профилей браузера.
  • Один профиль после очистки данных получает новый endpoint.
  • Выход из аккаунта отвязывает подписку согласно политике продукта, но не должен молча подписывать следующего пользователя.
  • Отписка от категории не всегда означает глобальный unsubscribe — сервер фильтрует topics отдельно.
  • Кнопка «выключить всё» деактивирует все принадлежащие аккаунту endpoints либо ясно сообщает, что действует только на это устройство.

Особенно опасна общая строка device_id без истории владельца: после смены аккаунта сообщения могут уйти не тому человеку. Храните связь subscription ↔ account с версией согласия и закрывайте прежнюю связь при logout или смене пользователя.

Ответ push service очищает мёртвые адреса

RFC 8030 требует вернуть 404 для истёкшей push subscription. Такой ответ является терминальным для этого endpoint: строку деактивируют и не ставят в бесконечный retry. Другие коды трактуются по документации конкретного сервиса; общий сетевой timeout сам по себе не доказывает, что адрес умер.

Service worker не показывает одну доставку дважды

В обработчике push должна быть одна точка showNotification. Если библиотека уже отображает payload, второй ручной вызов создаст дубль, который пользователь примет за продолжение рассылки. Добавьте event_id и осмысленный tag, но не используйте tag для скрытия реально разных сообщений.

Отписку проверяют в четырёх состояниях

Прогоните активную подписку, server-disabled при ещё существующей browser subscription, полностью удалённую подписку и повторное согласие с новым endpoint. Для расследования достаточно временной шкалы, endpoint hash, статуса строки, кода ответа push service и обезличенного event_id; реальные ключи p256dh/auth передавать не нужно.

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