Отписка должна остановить две вещи: выбор endpoint на вашем сервере и подписку браузера у push service. Если кнопка меняет только локальный переключатель, фоновая рассылка продолжает брать старую строку из базы. Начните с server-side disable — он прекращает новые отправки даже при сбое браузерного unsubscribe.
Не тестируйте массовой рассылкой. Создайте отдельную подписку, сохраните hash endpoint, отправьте одно сообщение, откажитесь от уведомлений и повторите через тот же диагностический job. Полный endpoint и ключи подписки в обычный лог не выводятся: они позволяют адресовать браузер.
Одинаковый симптом оставляет разные следы
| Наблюдение | Вероятная причина | Следующая проверка |
|---|---|---|
| Send job создан после opt-out | Backend не фильтрует active=false | Запрос отбора получателей |
| Job старше opt-out | Сообщение уже было принято push service | created_at и TTL |
| Другой endpoint hash | Второй профиль или старая подписка | Список endpoint устройства/аккаунта |
| Один push показан дважды | Два обработчика showNotification | Лог service worker и tag |
| Отписка пропала после reload | UI не читает фактическое состояние | 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.
Порядок действий переживает обрыв сети
- UI блокирует переключатель и отправляет серверный disable.
- Backend перестаёт выбирать endpoint для новых рассылок.
- Браузер получает текущую PushSubscription и вызывает unsubscribe.
- Клиент показывает подтверждение только после понятного результата обоих шагов.
- Неоконченный browser step можно повторить, не меняя server-side отказ.
- Новая подписка создаётся только после нового осознанного согласия.
Если сеть исчезла сразу после 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 передавать не нужно.