Доработка сайтов · обновлено 17.11.2026

ChunkLoadError после релиза: как сохранить работу старой вкладки

Старая вкладка может запрашивать файл прошлой сборки, который исчез после выкладки. Сравните её с новой вкладкой, установите причину по ответу сервера и проверьте исправление вместе с откатом.

Оценить доработку

Содержание статьи

После релиза сайт открывается в новой вкладке, а в старой перестаёт работать переход в каталог или форму. При ChunkLoadError сначала сравните адрес недоступного скрипта и ответ сервера: вкладка могла сохранить ссылки на файлы прошлой сборки, но возможны и другие причины. Исправление нужно принимать на вкладке, открытой до выкладки, — успешной загрузки главной страницы недостаточно.

Три безопасных первых действия:

  1. Сохраните введённый текст доступным в приложении способом и зафиксируйте шаг, после которого возникла ошибка. Не повторяйте оплату или отправку заказа вслепую.
  2. Запишите время, браузер и версию релиза, если она показана. Во вкладке Network инструментов разработчика найдите неудачный запрос скрипта: нужны его путь, код ответа и тип содержимого.
  3. Повторите только безопасный переход в новой вкладке. Старую пока не закрывайте: она нужна для сравнения.

Что именно не загрузилось

Chunk — отдельный файл с частью JavaScript-кода. Он может понадобиться только при переходе в раздел: например, код редактора загружается после нажатия кнопки. Уже открытая страница продолжает выполнять старый код, даже если на сервере появился новый выпуск.

В учебном примере вкладка открыта на сборке A и при переходе запрашивает /assets/releases/A/editor.a1.js. После выкладки B этот файл удалили, а новый называется editor.b2.js. Старая вкладка не узнаёт новый адрес автоматически. Такой сценарий описан в документации webpack по кешированию и в руководстве Vite по производственной сборке.

Ошибка загрузки ещё не доказывает удаление файла. Если раздел не открылся, посетитель может не завершить действие, но из сообщения в консоли нельзя вывести число потерянных заявок или назвать единственную причину.

Матрица проверки: вкладка, адрес, ответ

На тестовой копии откройте сборку A и оставьте вкладку. Выберите раздел, код которого ещё не загружался; при автоматической предзагрузке разработчику нужно проверить это в Network. Затем выпустите B тем же способом, что используется на рабочем сайте, и повторите переход в старой и новой вкладках.

Ниже — учебная матрица для записи результата. Пути условные, это не журнал клиентского проекта.

ПроверкаКакой файл ожидаетсяЧто фиксировать
Вкладка A до выкладкиФайл сборки AПуть и успешную загрузку выбранного раздела
Другая вкладка A, оставленная до выкладки BЕщё не загруженный файл AТочный запрос, HTTP-ответ, тип содержимого
Новая вкладка после выкладки BФайл сборки BТе же сведения для того же перехода
Вкладка B после пробного отката на AФайл сборки BДоступен ли он после отката

Для каждой строки отметьте, пришёл ли ответ из браузерного кеша, через сеть доставки контента (CDN) или с сервера. Отдельно сохраните результат самого действия: открылся ли редактор, сохранилась ли тестовая запись. Ответ 200 сам по себе не подтверждает работоспособность.

В диагностический отчёт не переносите cookie, токены, содержимое форм и полный сетевой архив без проверки. Обычно достаточно обезличенного пути файла, времени, статуса ответа и шага воспроизведения.

Как различить причины по ответу

Старая вкладка получает 404, новая работает. Сопоставьте запрошенный путь со списком файлов сохранённой сборки A. Если файл был в A и исчез именно при выпуске B, проверяйте удаление старых ресурсов. Для восстановления используйте исходный артефакт A, а не новый файл под старым именем: содержимое должно соответствовать коду старой вкладки.

Обе вкладки запрашивают неверный путь. Сравните адрес в Network с адресом размещённого файла. В webpack базовый путь ресурсов задаёт output.publicPath; в Vite проверьте base. Поправка зависит от сборщика, его версии и способа размещения. Не меняйте настройку по одному названию ошибки.

По адресу скрипта приходит HTML с кодом 200. Проверьте Content-Type и начало ответа. Сервер мог вернуть страницу входа или главную страницу вместо отсутствующего файла. Разработчику нужно разделить маршруты приложения и выдачу статических ресурсов, а затем повторить запрос. Переименование HTML в JavaScript проблему не решает.

Файл существует, но загрузка блокируется или обрывается. Сопоставьте Network с сообщением консоли: возможны сетевой обрыв, запрет доступа или политика безопасности браузера. Сохранять старые сборки в этом случае недостаточно. Нельзя отключать защитные правила на всём сайте ради исчезновения сообщения.

Если используется service worker — фоновый обработчик браузера, который может управлять кешем, — его версию и правила обновления проверяют отдельно. Очистка браузера полезна как сравнительный тест, но не заменяет объяснение причины.

Как выкладывать сборку и сохранять старые файлы

Для подтверждённого удаления ресурсов подходит схема с отдельными каталогами выпусков. Сначала команда полностью размещает B, проверяет доступность её файлов, затем переключает выдачу HTML и таблицы соответствия файлов на B. Старые URL сборки A продолжают вести к исходным файлам A.

Пример структуры:

/assets/releases/A/editor.a1.js
/assets/releases/B/editor.b2.js

Это схема размещения, а не готовая конфигурация сервера. Для нескольких серверов нужно до переключения проверить доступность нового комплекта на всех узлах, которые обслуживают эти запросы. Одного переключения каталога на одном сервере недостаточно.

Версионированные файлы не перезаписывают: изменилось содержимое — изменился адрес. HTML проверяют отдельно: для повторного использования актуальной версии может применяться Cache-Control: no-cache. Эта директива требует перепроверки сохранённого ответа, а не запрещает хранение. Она также не обновляет код уже открытой вкладки. Конкретные правила согласуют с кешем платформы и персонализацией страниц.

Как определить срок хранения

Универсального срока нет. Сначала команда задаёт, как долго поддерживает работу открытой вкладки без обновления, сколько времени может выдаваться старый HTML и в течение какого периода нужен откат.

Практическое правило для регламента: старые файлы сохраняются как минимум до окончания поддерживаемого времени жизни вкладки, отсчитанного от последней допустимой выдачи HTML этой сборки, с согласованным запасом. Одновременно должны оставаться ресурсы выпусков, доступных для отката. При возврате на A сроки пересчитывают: новые посетители снова получают A.

Хранение «двух последних сборок» ненадёжно при частых выпусках: обе могут смениться за время работы одной вкладки. Перед удалением сверяют сроки, список сохраняемых выпусков и обращения к старым URL. Отсутствие запросов сейчас не доказывает, что спящая вкладка не обратится позже.

После окончания поддерживаемого срока нужен понятный переход на новую версию с защитой несохранённой работы. Бесконечная автоматическая перезагрузка опасна: при недоступном файле или отсутствии сети она повторяет сбой. Предпочтительнее предложить обновление страницы после сохранения данных и не повторять бизнес-операцию автоматически.

По каким признакам принять исправление

Проверка должна повторять исходное условие: вкладка открыта до релиза, нужный раздел ещё не загружен. На тестовом контуре подтвердите:

  • вкладки A и B получают свои файлы по прежним адресам в течение согласованного срока;
  • вместо скрипта не возвращается HTML, а переход и тестовое действие завершаются;
  • при пробном откате работают и оставленная вкладка B, и новая вкладка A;
  • отсутствие сети вызывает понятное сообщение без цикла перезагрузок;
  • после окончания срока поддержки старой вкладки предусмотрено обновление без неожиданной потери введённого текста.

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

Общий порядок согласования и выпуска изменений разобран в статье о безопасном процессе доработки сайта. Здесь критерий уже: ранее открытая вкладка сохраняет возможность загрузить свой код.

Когда достаточно своих проверок, а когда нужна доработка

Владелец или руководитель проекта может собрать время сбоя, безопасные шаги и сравнение вкладок. Если команда управляет сборкой и размещением, умеет воспроизвести ошибку на копии и проверяет откат, исправление можно выполнить своими силами.

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

Для оценки пригодятся симптом, время, версия релиза и обезличенная строка из матрицы. Пароли, токены и полные журналы для первого обращения не нужны.

Нужно исправить описанный сценарий на сайте?

Начнём с одной воспроизводимой задачи. Согласуем результат диагностики, состав доработки и критерии приёмки.

Описать задачуСвернуть форму

Оценить доработку

Укажите телефон или почту для ответа и коротко опишите задачу.

Сначала уточним задачу, затем согласуем состав, стоимость и результат первого этапа. Не отправляйте пароли, токены и приватные данные.

Еще по теме