Страница приложения — цепочка ресурсов. Сервер может вернуть корректный 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.jsHTTP/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 главной страницы.
- Исправлять белый экран только очисткой своего кеша.
- Отключать проверки типа вместо исправления ответа сервера.
Как доказать восстановление
- HTML ссылается на доступный ассет нужной версии.
- Тело и Content-Type согласованы с модулем; новых ошибок запуска нет.
- Проверены видимый интерфейс и обычная повторная загрузка.
МИНИ-ИНЦИДЕНТ
Почему подмена имени не завершила ремонт?
Теперь модуль существует, но 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Почему успех нового клиента не означает общий ремонт?
Сверить рассуждение
Существующие клиенты могут ещё использовать валидный кеш старого HTML. Контракт публикации должен учитывать и эти ссылки.
Что сравнить в политике релиза?
Сверить рассуждение
Время кеширования документа, имена ассетов и срок хранения предыдущих версий. Изменение одного Cache-Control не возвращает уже удалённый bundle.
Какая проверка отражает опыт пользователей?
Сверить рассуждение
Обычная повторная загрузка существующей сессии и загрузка новой. В обеих должен запуститься интерфейс без ошибки входного модуля.
ПРОВЕРЬ СЕБЯ
Почему no-cache не равен no-store?
Показать объяснение
Первый допускает хранение, но требует проверки перед повторным использованием. Второй запрещает хранение ответа. Выбирай политику по назначению ресурса, а не как универсальное средство от белого экрана.
Пока без комментариев. Поделись первым впечатлением или задай вопрос по теме.