`example.com` и `app.example.com` имеют общий site, но разные origins. Для PWA эта разница решающая: service worker привязан к origin и пути регистрации, а навигационный scope manifest тоже не включает другой origin. CORS может разрешить чтение API, но не превращает два поддомена в одну область управления.

Первый безопасный шаг — не очищать весь профиль браузера. Откройте страницу, с которой пользователь устанавливает приложение, и запишите фактические URL документа, manifest, `start_url`, `scope`, файла service worker и `registration.scope`. Ошибка обычно видна уже в этой шестёрке.

Четыре scope отвечают за разные вещи

МеханизмЧто ограничиваетПереходит на поддомен?
manifest scopeнавигации в режиме приложениянет, нужен тот же origin
service worker scopeконтролируемые запросы/страницынет
cookie Domainотправку cookie хостамможет, по отдельным правилам
CORSчтение cross-origin ответаразрешает запрос, не меняет origin
storage/IndexedDBданные originнет

Общая cookie иногда сохраняет серверную сессию, поэтому вход выглядит рабочим, а кеш и push исчезают. Это не противоречие: cookie, service worker registration и storage живут по разным моделям.

Manifest проверяется от страницы установки

<!-- https://app.example.com/ -->
<link rel="manifest" href="/manifest.webmanifest">

{
  "id": "/",
  "start_url": "/",
  "scope": "/",
  "display": "standalone"
}

По Web App Manifest `start_url` принимается только если он same-origin с документом, а `id` должен быть same-origin со start URL. Навигационный scope также сравнивает origin и затем префикс пути. Относительные URL удобно разрешаются относительно manifest, поэтому после переноса всегда смотрите уже вычисленные значения в DevTools.

Service worker остаётся на своём origin

Регистрация на `https://example.com/sw.js` не может контролировать `https://app.example.com/`. Заголовок `Service-Worker-Allowed` снимает ограничение каталога — например, позволяет файлу `/assets/sw.js` получить scope `/` — но не разрешает другой origin. На app-поддомене нужен собственный worker, отданный по HTTPS с корректным JavaScript MIME type.

// Выполняется на https://app.example.com/
const reg = await navigator.serviceWorker.register('/sw.js', {scope: '/'});
console.log({
  page: location.origin,
  script: reg.active?.scriptURL,
  scope: reg.scope
});

Выберите архитектуру, а не набор исключений

ВариантКогда подходитЦена
вся PWA на app.example.comкабинет — самостоятельное приложениесвой manifest, SW, push subscriptions
один origin, API по /apiнужен единый offline-контурreverse proxy до backend
две отдельные PWAсайт и кабинет — разные продуктыдве identity/установки и миграция
страница вне scopeредкий переход на сайтбраузерный UI вместо standalone

Не расширяйте cookie на `.example.com` только ради PWA: широкая Domain увеличивает число хостов, которым браузер отправляет credential. Сессию и API проектируют отдельно, с `Secure`, подходящим `SameSite`, CSRF-защитой и минимальным охватом.

Старая установка имеет прежнюю identity

После смены origin браузер видит другую identity приложения: manifest `id` не может перескочить на новый origin. Планируйте перенос как миграцию, а не как обычное обновление. Старое приложение может открыть страницу с объяснением и ссылкой на новую установку, но незаметно превратить существующую установку другого origin в новую нельзя.

Диагностика идёт в чистом профиле и старой установке

  1. На app-поддомене получить manifest и все icon URL с HTTP 200.
  2. Проверить вычисленные id, start_url и scope на тот же origin.
  3. Убедиться, что registration.scope включает страницу запуска.
  4. Перезагрузить страницу и проверить `navigator.serviceWorker.controller`.
  5. Установить PWA в чистом тестовом профиле и запустить по иконке.
  6. Отдельно открыть старую установку и проверить сценарий миграции.
  7. Проверить offline и push заново: подписка привязана к регистрации worker.

Успех проверяется по URL, а не по зелёной галочке

  • Запуск открывает ожидаемый start_url на app.example.com.
  • Навигации внутри scope сохраняют standalone presentation.
  • Страница контролируется worker нужной версии и origin.
  • Offline fallback не перехватывает API или чужой поддомен.
  • После обновления cache version старые assets не смешиваются с новыми.
  • Вторая PWA не заменяет первую из-за случайного совпадения id на одном origin.

Для совместного разбора сохраните manifest JSON, вычисленные URL, registration.scope/scriptURL, response headers файла worker, скрин Application панели и матрицу чистая/старая установка. Cookies и push endpoint передавать не требуется.

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