Network First сначала ждёт сеть и обращается к кешу после ошибки. При «подключённом», но почти не передающем данные интернете ошибка может наступить слишком поздно, поэтому пользователь видит бесконечный spinner. В Workbox задайте `networkTimeoutSeconds`, но сначала убедитесь, что для этого URL действительно есть пригодная кешированная версия.

Timeout не создаёт offline-ответ из воздуха. При первом визите и пустом кеше стратегия завершится ошибкой. Для навигации подготовьте offline page или прогрейте ключевой маршрут; для персональных API-ответов решите, допустимо ли вообще показывать устаревшие данные другому состоянию авторизации.

Разделите три режима одной навигации

УсловиеОтвет пользователюЧто проверить
Сеть быстраяСвежий network responseОтвет кешируется только при допустимом статусе
Сеть медленная, cache hitКеш после timeoutПонятна давность данных и сеть не блокирует UI
Сеть недоступна, cache hitКеш после network failureСтраница не требует отсутствующих API для первого рендера
Сеть медленная, cache missКонтролируемый fallback или errorНе остаётся бесконечный spinner
Сервер вернул 500Ошибка либо прежний кеш по явной политике5xx случайно не записывается как полезный ответ

Не применяйте одну стратегию ко всем запросам. HTML-навигация, versioned JS, изображения и операции записи имеют разные требования. POST не должен превращаться в кешированное чтение; персональный JSON требует ключа, учитывающего пользователя, либо вообще исключается из runtime cache.

Workbox настраивается на конкретный маршрут

import {registerRoute} from 'workbox-routing';
import {NetworkFirst} from 'workbox-strategies';
import {CacheableResponsePlugin} from 'workbox-cacheable-response';

registerRoute(
  ({request, url}) =>
    request.mode === 'navigate' && url.origin === self.location.origin,
  new NetworkFirst({
    cacheName: 'pages-v3',
    networkTimeoutSeconds: 3,
    plugins: [new CacheableResponsePlugin({statuses: [200]})],
  })
);

Три секунды здесь — пример из page cache recipe Workbox, а не универсальный SLA. Измерьте свою аудиторию и вес страницы. Слишком короткий timeout часто покажет старый контент при нормальной мобильной сети; слишком длинный вернёт исходную проблему.

Кеш должен иметь правила свежести и очистки

Имя `pages-v3` помогает отделить схему кеша после релиза. Удаляйте старые версии в activate или используйте управляемый expiration plugin. Без ограничения runtime cache растёт, а пользователь может получать страницу, несовместимую с новыми assets.

  • Кешируйте только ответы с ожидаемым статусом и origin.
  • Не сохраняйте login redirect как страницу приложения.
  • Показывайте признак офлайн- или устаревшего режима, если данные могут измениться.
  • Версионируйте assets по содержимому и не смешивайте их с HTML runtime cache.
  • Обрабатывайте ошибку стратегии в catch handler, если cache miss допустим.

Старый service worker может скрыть исправление

После деплоя откройте Application → Service Workers и убедитесь, что активна нужная версия. Новый worker может ждать закрытия старых вкладок. Кнопка Skip waiting полезна только при продуманном обновлении: принудительная активация способна смешать открытый UI и новый протокол кеша.

В Network панели пометьте, какой ответ пришёл from ServiceWorker, а в Cache Storage найдите точный request URL. Наличие похожего URL с другим query или trailing slash не является cache hit. Проверьте также `Vary` и то, не меняет ли роутер адрес после redirect.

Контрольная матрица на четырёх прогонах

Сначала загрузите страницу онлайн и подтвердите запись. Затем проверьте Fast network, Slow 3G, Offline и первый визит в чистом профиле Offline. Запишите time to first content и источник ответа. Исправление принято, если медленная сеть возвращает допустимый кеш за выбранный предел, а cache miss показывает понятный fallback вместо вечного ожидания.

Для разбора подготовьте service worker, правила registerRoute, список Cache Storage и HAR без cookies и токенов. Одного скриншота spinner недостаточно: нужен timing проблемного request и состояние кеша.

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