`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 в новую нельзя.
Диагностика идёт в чистом профиле и старой установке
- На app-поддомене получить manifest и все icon URL с HTTP 200.
- Проверить вычисленные id, start_url и scope на тот же origin.
- Убедиться, что registration.scope включает страницу запуска.
- Перезагрузить страницу и проверить `navigator.serviceWorker.controller`.
- Установить PWA в чистом тестовом профиле и запустить по иконке.
- Отдельно открыть старую установку и проверить сценарий миграции.
- Проверить 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 передавать не требуется.