Fallback решает только состояние ожидания. Если import завершился ошибкой, интерфейс должен перейти в другой экран с понятным действием. Поэтому сначала замедлите запрос chunk, затем отдельно верните ему 404: это два разных теста и два разных обработчика.

Boundary ставят рядом с самостоятельным экраном, а не вокруг всего приложения. Тогда медленный редактор не заменяет навигацию глобальным spinner. Сохраняйте уже доступный контент, если новая часть может грузиться независимо.

Симптом определяет, какой переход потерян

НаблюдениеСостояние PromiseЧто отсутствует
Пустой блок до загрузкиpendingБлижайший loading fallback
Spinner навсегдаPromise не завершён или timeout не заданОграничение времени и диагностика сети
Белый экран после 404 chunkrejectedError Boundary/errorComponent
После deploy помогает reloadСтарый HTML просит удалённый chunkСовместимое хранение assets и стратегия обновления
Retry ничего не делаетКешируется отклонённый loaderНовая попытка на корректном уровне

В React lazy кеширует Promise загрузчика и его результат. При reject ошибка передаётся ближайшей Error Boundary, а Suspense показывает fallback во время ожидания. Один Suspense без обработки ошибки не покрывает весь жизненный цикл.

Минимальная граница показывает три состояния

<ChunkErrorBoundary fallback={<RetryPanel />}>
  <Suspense fallback={<EditorSkeleton />}>
    <LazyEditor />
  </Suspense>
</ChunkErrorBoundary>

// Retry должен создать новую попытку, а не просто скрыть ошибку.

Компонент lazy объявляют на верхнем уровне модуля. React отдельно предупреждает, что объявление lazy внутри родительского компонента пересоздаёт identity и сбрасывает state. Skeleton должен совпадать по размеру с будущим экраном, чтобы не прыгала раскладка.

Vue задаёт loading и error явно

Vue defineAsyncComponent принимает loadingComponent, errorComponent, delay и timeout. Документация отмечает, что loader возвращает Promise и может завершиться reject. Если async component подчинён родительскому Suspense, собственные loading/error options могут вести себя иначе; проверьте параметр suspensible и выбранную архитектуру.

  • Короткая delay убирает мигание spinner на быстром соединении.
  • Timeout переводит ожидание в объяснимую ошибку, но не отменяет запрос автоматически.
  • Error UI различает offline, 404 устаревшего chunk и ошибку выполнения модуля.
  • Retry ограничен и не запускается циклом при постоянном 404.
  • Событие наблюдения содержит route, release ID и тип ошибки без URL с токенами.

Новый деплой не должен ломать старую вкладку

HTML, открытый до релиза, может ссылаться на chunk предыдущей версии. Не удаляйте хешированные assets мгновенно: держите их дольше максимальной жизни страницы или направляйте к совместимому хранилищу. Service worker и CDN должны обновляться согласованно; бесконечный принудительный reload создаёт цикл.

Если приложение предлагает «Доступна новая версия», сохраните черновик и только потом обновляйте страницу. Автоматический reload допустим лишь для доказанной chunk load error, один раз и с маркером попытки. Ошибку бизнес-компонента нельзя маскировать таким обновлением.

Проверка намеренно ломает доставку кода

  1. Задержать chunk и увидеть skeleton без исчезновения навигации.
  2. Вернуть 404 и получить error UI, а не вечный spinner.
  3. Отключить сеть, нажать retry после восстановления и загрузить компонент.
  4. Открыть старую вкладку, выполнить новый deploy и перейти на lazy route.
  5. Проверить сохранение фокуса, черновика и отсутствие цикла reload.

Для разбора нужны версия framework, определение lazy/async component, расположение boundaries, Network-запись проблемного chunk и release policy для assets. По этому набору видно, зависло ожидание, потеряна ошибка или старый клиент запросил уже удалённый файл.

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