Урок 3 из 10Диагностика

14 мин · теория и практика · Основы

Белый экран: JavaScript, MIME и кеш релиза

Проверить не только HTML, но и загрузку приложения, версию ассетов и ошибки браузера.

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

Страница приложения — цепочка ресурсов. Сервер может вернуть корректный HTML со статусом 200, но интерфейс не появится, если модуль не загрузился или упал при запуске. Первый полезный вопрос: что именно должен был выполнить браузер?

Сохрани первую ошибку запуска

Открой страницу и вкладки Console и Network. Первая ошибка загрузки или исполнения часто полезнее последующих ошибок, вызванных отсутствующим модулем. Запиши URL ресурса, статус, тип ответа и краткий текст ошибки.

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

Прочитай ресурс по точному URL из HTML

Убедись, что script ссылается на опубликованную версию ассета. Запрос к похожему app.js не проверяет bundle с другим именем. HTML и каталог релиза должны образовывать согласованную пару.

Проверь тело GET-ответа: иногда на отсутствующий файл маршрутизатор возвращает HTML главной страницы со статусом 200. По одному HEAD или размеру файла невозможно доказать наличие нужного JavaScript.

Команды
curl -sS --max-time 5 http://localhost/
curl -sS -i --max-time 5 http://localhost/assets/bundle.8a1.js
Пример вывода
HTTP/1.1 200 OK
Content-Type: text/html

<!doctype html>...

Свяжи MIME с режимом загрузки

JavaScript-модуль должен пройти проверку типа ответа. HTML вместо модуля или неподходящий MIME нельзя исправить тем, что файл существует на диске. Исследуй location, alias/root и таблицу типов nginx.

Сообщение Console должно согласовываться с ответом Network. Если тип и тело уже правильные, переходи к ошибке исполнения и зависимым запросам приложения, а не продолжай менять MIME вслепую.

Команды
sudo nginx -T
curl -sS -D - -o /dev/null --max-time 5 http://localhost/assets/bundle.8a1.js

Проверь согласованность кеша и релиза

Кеш может сохранить HTML, который ссылается на удалённый старый bundle. Имена с хешем помогают различать версии, но требуют согласованной публикации и политики хранения старых ассетов. Очистка браузера одного человека не исправляет релиз для остальных.

no-cache требует проверки актуальности перед повторным использованием, а no-store запрещает хранение ответа. 304 при корректной проверке не означает пустой ресурс: браузер использует сохранённое представление. Сравни обычную загрузку и новую сессию, затем проверь сам пользовательский экран.

От симптома к проверке

НаблюдениеСледующая проверкаКак читать результат
HTML 200, интерфейс пустConsole и запрос входного модуляПроверяется запуск, а не доступность документа.
Ассет 200 с HTML внутриТочный URL, location и fallbackУспешный статус не делает тело JavaScript.
Новая сессия работает, старая нетВерсии HTML и ассетов, кеш-заголовкиПроверь контракт публикации для существующих клиентов.

Типовые ошибки

  • Закрывать инцидент после curl главной страницы.
  • Исправлять белый экран только очисткой своего кеша.
  • Отключать проверки типа вместо исправления ответа сервера.

Как доказать восстановление

  1. HTML ссылается на доступный ассет нужной версии.
  2. Тело и Content-Type согласованы с модулем; новых ошибок запуска нет.
  3. Проверены видимый интерфейс и обычная повторная загрузка.

МИНИ-ИНЦИДЕНТ

Почему подмена имени не завершила ремонт?

Теперь модуль существует, но Console сообщает о text/plain. Что сравнить перед новой правкой?

Данные для разбора
script type=module src=/assets/bundle.8a1.js
GET /assets/bundle.8a1.js → 200, Content-Type: text/plain
Разобрать ход диагностики

Сверь реальный GET-ответ и эффективный location, который отдаёт этот путь. Две независимые проблемы могут существовать одновременно: неверная версия и неверный тип. После исправления типа всё равно нужна проверка запуска страницы и повторной загрузки.

ПРАКТИКУМ

Практикум: объясни данные и выбери действие

Существующий и новый клиент получили разные версии HTML.

Учебные данные
old HTML → bundle.a1.js → 404
new HTML → bundle.b2.js → 200
old HTML Cache-Control: max-age=3600
  1. Почему успех нового клиента не означает общий ремонт?

    Сверить рассуждение

    Существующие клиенты могут ещё использовать валидный кеш старого HTML. Контракт публикации должен учитывать и эти ссылки.

  2. Что сравнить в политике релиза?

    Сверить рассуждение

    Время кеширования документа, имена ассетов и срок хранения предыдущих версий. Изменение одного Cache-Control не возвращает уже удалённый bundle.

  3. Какая проверка отражает опыт пользователей?

    Сверить рассуждение

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

ПРОВЕРЬ СЕБЯ

Почему no-cache не равен no-store?

Показать объяснение

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

Документация

Гостевой прогресс хранится отдельно в этом браузере.

ТЕПЕРЬ В КОНСОЛЬ

Закрепи на инциденте

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

ПОМОГЛО РАЗОБРАТЬСЯ?

Как тебе материал?

Оцени статью или напиши, где не хватило объяснения. Это поможет улучшить обучение.

Полезно 0 Не помогло 0

Войди, чтобы оценить статью и оставить комментарий.

Обсуждение

0

Войти в обсуждение →

Пока без комментариев. Поделись первым впечатлением или задай вопрос по теме.