Пустая страница на сайте — один из самых неприятных симптомов, потому что пользователь не видит даже понятной ошибки. Но для диагностики это не тупик: браузер, сервер и PHP-логи обычно показывают, что произошло.
Белый экран может быть результатом PHP Fatal Error, ошибки шаблона, пустого ответа backend, неправильного кеша, сломанного JavaScript или конфигурации сервера.
С чего начать диагностику
Сначала нужно понять, что именно приходит в браузер: пустой HTML, ошибка 500, нормальный HTML без данных или страница, которую ломает JavaScript.
- Проверить код ответа страницы в Network.
- Открыть исходный код страницы и понять, есть ли HTML.
- Посмотреть Console на ошибки JavaScript.
- Проверить PHP error log и логи веб-сервера.
- Отключить кэш только после копии и понимания, какой слой кэширует страницу.
Частые причины
- PHP Fatal Error до вывода HTML
- шаблон CMS отдает пустой контент
- сломался JavaScript и скрывает основной блок
- кэш сохранил пустой ответ
- неверная настройка nginx/apache
- после обновления темы или плагина пропал вывод страницы
Что можно проверить без риска
Для первичной диагностики полезно отделить frontend от backend: есть ли HTML, есть ли ответ сервера, есть ли ошибки в консоли.
- проверить исходный код страницы
- посмотреть код ответа во вкладке Network
- сохранить ошибки из Console
- проверить, пустая только одна страница или весь сайт
- не включать постоянный публичный вывод ошибок без необходимости
Когда лучше не экспериментировать
Не стоит сразу очищать все данные, отключать тему или удалять плагины. Пустая страница может быть одной строкой в шаблоне, а грубые действия затронут весь сайт.
Как я обычно чиню такую проблему
Я определяю слой, на котором исчезает контент: сервер, PHP, CMS-шаблон, кэш или JavaScript. После этого правка обычно становится точечной.
- Смотрю симптомы: адрес страницы, скриншот ошибки, время появления, что меняли перед сбоем.
- Проверяю серверные логи, конфигурацию сайта, права файлов, базу данных и зависимости.
- Делаю точечную правку: без лишней смены CMS, шаблона или случайной установки плагинов.
- Проверяю результат на основной странице, мобильной версии, формах и важных пользовательских сценариях.
- Кратко объясняю, что сломалось и что сделать, чтобы ошибка не повторялась.
Что подготовить для оценки
- адрес сайта или проблемной страницы
- когда появилась ошибка и что меняли перед этим
- доступ к хостингу, серверу или админке, если он нужен для проверки
- скриншот ошибки или текст из консоли, если он есть
- приоритет: срочно восстановить работу или спокойно разобраться в причине
Сроки
| PHP/JS-ошибка на одной странице | 30-90 минут |
|---|---|
| Проблема шаблона или CMS | 1-3 часа |
| Кэш, сервер и несколько окружений | после диагностики |
Вопрос-ответ
Белый экран — это всегда ошибка PHP?
Нет. Часто это PHP, но также бывает JavaScript, CSS, кэш, пустой шаблон или неверный ответ API.
Почему админка работает, а страница пустая?
Публичный шаблон и админка используют разные части кода. Ошибка может быть только в теме, модуле или конкретном шаблоне.
Можно ли быстро понять причину?
Да, если есть доступ к логам и можно посмотреть ответ страницы в Network. Без логов диагностика дольше.
Итог
Пустая страница не означает, что причины нет. Нужно проверить ответ сервера, HTML, консоль, PHP-логи и кэш, а затем исправить конкретный слой, где пропал вывод.
Если нужно быстро разобраться с такой ошибкой на сайте, напишите в Telegram: @rabotator_support. Посмотрю симптомы, скажу, что нужно проверить, и предложу аккуратный план исправления.