Что такое пуш-токен — и почему он меняется сам по себе

Смотри, какая штука. У тебя в базе тысяча пуш-токенов, ты шлёшь уведомление — доходит до семисот. Никто не отписывался, приложение не удаляли. Просто триста адресов протухли, и это не баг, а нормальная жизнь пуш-токена.
Разберёмся, что это за адрес такой, почему он меняется сам и что с этим делать, чтобы твоя рассылка не превращалась в стрельбу по пустым квартирам.
Что такое пуш-токен простыми словами
Пуш-токен — это длинная строка, адрес, по которому можно доставить уведомление на конкретную установку твоего приложения на конкретном телефоне.
Три слова здесь важны:
- Адрес, а не имя. Ты шлёшь не «Пете», а на адрес. Если Петя поставил приложение на телефон и планшет — это два разных токена.
- Выдаёшь его не ты. Токен приходит от службы уведомлений операционной системы: APNs у Apple, FCM у Google. Твой сервер лишь получает готовую строку.
- Он про установку. Удалили приложение и поставили заново — адрес другой. Тот же человек, тот же телефон, но новая «квартира».
Само по себе наличие токена ничего не гарантирует. Нужно ещё разрешение на уведомления — без него токен есть, а уведомления не показываются.
Как пуш вообще доходит
Тут ломается главное заблуждение новичка: твой сервер никогда не стучится в телефон напрямую. Телефон не сервер, у него нет постоянного адреса, он спит и меняет сети.
Цепочка всегда такая:
- Приложение при запуске просит у системы токен.
- Система выдаёт строку и отправляет её приложению.
- Приложение шлёт токен на твой сервер — обычным запросом к твоему API.
- Когда нужно уведомление, твой сервер обращается не к телефону, а к APNs или FCM: «доставь вот это вот по такому адресу».
- Служба уведомлений держит с телефоном свой канал и доставляет сама.
Поэтому у тебя нет способа «проверить, дошло ли». Ты отдаёшь письмо на почту — дальше её зона ответственности.
Почему токен живёт своей жизнью
Вот тут самое интересное. Apple прямо перечисляет случаи, когда токен гарантированно будет другим: пользователь восстановил телефон из резервной копии, поставил приложение на новое устройство, переустановил операционную систему. И даёт жёсткое правило: приложениям никогда не следует кэшировать токены — запрашивай у системы при каждом запуске.
Причина не в занудстве. В документации есть важная деталь: когда токен изменился, пользователь должен хотя бы раз открыть приложение, прежде чем уведомления снова начнут доходить. То есть после смены телефона твои пуши молчат ровно до первого запуска — и, если ты кэшировал старый адрес, молчат навсегда.
Со стороны сервера тоже есть срок годности. У Google для Android сказано конкретно: если регистрация неактивна 270 дней, FCM считает её просроченной и удаляет.
Что с этим делать: четыре правила
- Запрашивай токен при каждом старте приложения. Если он не изменился, система вернёт его мгновенно — это дёшево. Если изменился, ты узнаешь сразу.
- Отправляй на сервер вместе с датой. Храни в базе не просто строку, а «токен + когда его последний раз видели». Так ты отличишь живой адрес от забытого два года назад.
- Удаляй мёртвые. Если служба уведомлений отвечает, что регистрация недействительна — у FCM это
UNREGISTEREDи код 404 — документация говорит прямо: такую запись можно спокойно удалять. Не удаляешь — платишь временем и лимитами за отправку в никуда. - Готовься к «много токенов на одного». Привязывай токены к пользователю списком, а не полем. Иначе вход с планшета молча выключит уведомления на телефоне.
Где ты встретишь его первым
Обычно — в первый же вечер, когда подключаешь уведомления через готовый сервис. Firebase, OneSignal и подобные прячут половину сложности, но не эту: в их инструкции всегда есть шаг «отправьте полученный токен на свой сервер» и обработчик «токен обновился».
Дальше у тебя в базе появляется табличка вида «пользователь — токен — платформа — когда обновлён». Именно она со временем зарастает мёртвыми адресами, если не делать четвёртый пункт из списка выше. Хорошая привычка на старте: сразу заведи поле с датой и раз в неделю смотри, сколько записей не обновлялось месяцами. Обычно это первое, что объясняет разрыв между «у нас тысяча пользователей» и «уведомление увидели семьсот».
Пуш-токен — это секрет?
Не такой, как ключ API, но и не публичные данные. Сам по себе чужой токен позволяет отправлять уведомления только тому, у кого есть твои серверные ключи. А вот в связке с ними — это прямой канал в чужой телефон. В логи и в клиентский код его выкладывать не надо.
Почему уведомление не пришло, хотя токен есть?
Три частые причины, по убыванию: нет разрешения на уведомления; токен устарел и его не обновили при запуске; телефон в режиме экономии, и доставка отложена до пробуждения. Начинай проверку сверху — она бесплатная.
Токен нужно генерировать самому?
Нет, и не пытайся. Токен выдаёт только служба уведомлений операционной системы, и никакая библиотека этого не обходит. Твоя задача — вовремя его получить, сохранить с датой и вовремя выбросить.
Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.





