Сравните один тестовый файл с обычным перехватом и с временным обходом worker в инструментах разработчика. Если напрямую файл проходит, найдите обработчик fetch, который возвращает ответ для этого URL. Причиной может быть чтение всего тела, неверная работа с диапазонами или попадание файла в общий offline fallback.

Сначала выясните, что именно получает клиент

ПроверкаЧто сравнить
Обычное скачиваниеСтатус, тип содержимого и размер
МедиаплеерRange и Content-Range
Offline fallbackНе вернулся ли HTML вместо файла
Обработка телаНе собирается ли ответ целиком в памяти
КэшированиеПолный объект или частичный ответ

Возьмите синтетический файл известного размера и проверяйте содержимое, а не только появление имени в загрузках. Ответ 200 с HTML-заглушкой тоже может сохраниться под ожидаемым именем. Сопоставьте реальный Content-Type и полученные байты до правки заголовка Content-Disposition.

Условная карта маршрутизации:
request -> точный URL и назначение
large download -> предусмотренный сетевой путь
cached media -> обработка диапазонов
app navigation -> допустимая offline-страница
other -> штатное поведение

Не отправлять все неизвестные запросы в HTML fallback.

Скачивание и воспроизведение имеют разные требования

Документация Workbox для кэшированных аудио и видео указывает на необходимость учитывать Range и использовать соответствующий модуль. Источник проверен 27 октября 2026 года. Готовый полный объект в кэше и частичный ответ сети — разные сущности; нельзя без проверки использовать один вместо другого.

Для обычного скачивания часто достаточно не перехватывать этот маршрут, если продукт не требует offline-доступа к файлу. Такое исключение должно быть точным по назначению и URL. Исключение всех запросов origin ради одного файла может незаметно отключить нужную offline-функцию приложения.

Проверьте вызовы blob, arrayBuffer и другие операции, которые материализуют тело целиком. На маленьком файле они незаметны, а на большом добавляют ожидание и расход памяти. Сохраняйте потоковую передачу там, где она предусмотрена, и не декодируйте бинарный ответ как текст.

Если файл должен храниться offline, заранее задайте предел размера и поведение при нехватке места. Нельзя сообщать «доступно без сети» после неудачной записи в Cache Storage. Учитывайте также смену версии файла: части разных редакций не должны смешиваться под одним ожидаемым объектом.

Один тест проходит через оба пути

  1. Выбрать разрешённый файл с известным содержимым.
  2. Снять ответ без перехвата и через worker.
  3. Проверить выбранный маршрут и операции над телом.
  4. Для медиа испытать переход в ещё не загруженную часть.
  5. Повторить с ошибкой сети и отсутствующим объектом в кэше.

Обход worker — диагностический шаг, а не окончательное исправление. После правки проверьте обычный пользовательский режим с активной регистрацией. Старый worker может продолжать обслуживать уже открытую вкладку, поэтому фиксируйте версию контроллера при каждом сравнении.

Не выключайте проверку доступа к файлу ради прямой загрузки. Сетевой маршрут должен сохранять авторизацию, а кэш — соответствовать политике данных. Подписанные URL и персональные ответы нельзя автоматически переносить в общий публичный кэш.

Для разбора подготовьте размер, тип запроса, версию worker и обезличенные заголовки двух ответов. Приёмка подтверждает совпадение содержимого, ограниченный расход ресурсов и правильную ошибку вместо подменённой HTML-страницы. У медиа отдельно проверяется произвольное чтение диапазона.

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