Як полагодити білий екран 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 →