Как починить белый экран WordPress (WSOD)

Краткий ответ: «Белый экран смерти» — это фатальная ошибка PHP с выключенным показом ошибок. Включите WP_DEBUG_LOG, прочитайте wp-content/debug.log и деактивируйте сбойный плагин или переключитесь на стандартную тему через WP-CLI. Начиная с WordPress 5.2, проверьте и почту админа — туда приходят ссылки recovery mode.

Обзор

WSOD — более тихий брат ошибки 500: PHP умер, ничего не отрендерилось, браузер показывает белое. Типичные триггеры — обновление плагина/темы с синтаксической или совместимой ошибкой, скачок версии PHP или исчерпание памяти. Современный WordPress часто перехватывает это и отправляет на админский адрес письмо со ссылкой входа в recovery mode.

Что нужно иметь

• SSH + WP-CLI — ремонт редко требует wp-admin.
• Проверенный ящик админа — ищите письмо «Your site is experiencing a technical issue» с recovery-ссылкой.

Пошаговая инструкция

1. Включите логирование в wp-config.php и воспроизведите:

   define('WP_DEBUG', true);
   define('WP_DEBUG_LOG', true);
   define('WP_DEBUG_DISPLAY', false);

2. Прочитайте фатальную ошибку: tail -n 30 wp-content/debug.log — она называет файл, напр. .../plugins/some-plugin/init.php on line 42.
3. Деактивируйте виновника:

   sudo -u www-data wp plugin deactivate some-plugin

   Виновата тема? sudo -u www-data wp theme activate twentytwentyfour
4. Белый экран после обновления PHP: в логе будет фатальная ошибка совместимости — обновите расширение/плагин или верните сайт на предыдущую версию PHP до исправления.
5. Белые только отдельные страницы: поднимите память (WP_MEMORY_LIMIT) и ищите в логе сообщения об исчерпании.
6. Заработало? Выключите показ ошибок, оставьте логирование, и в следующий раз обновляйте проблемный компонент на staging.

Типичные проблемы

• debug.log пустой: падение предшествует WordPress — смотрите лог PHP-FPM; opcode-кеш также может отдавать устаревший сломанный файл: sudo systemctl reload php8.3-fpm.
• WSOD только для залогиненных: плагин админ-бара или дашборда — recovery mode или деактивация через CLI всё равно работают.
• Recovery-письмо не приходит: VPS не умеет слать почту — почините исходящую почту потом, сейчас пользуйтесь WP-CLI.

Когда обращаться в поддержку

WSOD — уровень приложения; тикеты — канал на случай подозрения на платформу (сервер не отвечает, файловая система read-only) или если хотите платформенную проверку здоровья, пока вы дебажите приложение.

Частые вопросы

Почему экран белый, а не показывает ошибку?

PHP получил фатальную ошибку при выключенном display_errors (правильно для продакшена), поэтому ничего не отрендерилось. Полный текст ошибки ждёт в debug.log или в логе PHP-FPM.

Что такое recovery mode в WordPress?

С версии 5.2 WordPress перехватывает многие фаталы и шлёт админу специальную ссылку входа, которая открывает wp-admin с приостановленным сломанным расширением — можно чинить прямо из панели.

Белый экран появился сразу после обновления PHP — что делать?

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

Похожие статьи

• Как починить ошибку 500 в WordPress
• Как использовать staging для обновлений WordPress
• Как оптимизировать PHP для WordPress
• Как настроить бэкапы WordPress

Нужна помощь? Связаться с поддержкой Cloud2Y →