Jak naprawić „Biały Ekran Śmierci” (White Screen of Death) w WordPressie?

„Biały ekran śmierci” (ang. White Screen of Death – WSoD) to jeden z najbardziej frustrujących problemów w WordPressie. Twoja strona i panel administracyjny znikają, a zamiast nich widzisz tylko paraliżującą, pustą, białą stronę. Na szczęście, ten problem jest niemal zawsze możliwy do naprawienia, a ten przewodnik przeprowadzi Cię przez wszystkie możliwe scenariusze.

Co najczęściej powoduje Biały Ekran Śmierci?

Choć wygląda groźnie, przyczynę WSoD zazwyczaj da się zidentyfikować. Najczęściej jest to jeden z poniższych problemów:

• Konflikt wtyczek lub motywów: Niekompatybilna lub błędnie napisana wtyczka/motyw.
• Wyczerpanie limitu pamięci PHP: Skrypt na Twojej stronie potrzebuje więcej pamięci, niż serwer mu przydziela.
• Problem po stronie hostingu: Awaria serwera lub jego konfiguracji.
• Uszkodzone pliki rdzenia WordPressa: Kluczowe pliki mogły ulec uszkodzeniu podczas aktualizacji.
• Problem z pamięcią podręczną (cache): Uszkodzony plik cache może blokować renderowanie strony.
• Nieprawidłowe uprawnienia plików: Serwer nie ma uprawnień do odczytu kluczowych plików.
• Nieudana automatyczna aktualizacja: Proces aktualizacji mógł zostać przerwany, pozostawiając stronę w zawieszeniu.

Poniżej znajdziesz rozbudowaną instrukcję, jak krok po kroku zdiagnozować i rozwiązać ten problem, zaczynając od najprostszych metod.

Kroki do rozwiązania problemu WSoD

Sprawdź, czy problem nie leży po stronie hostingu

Zanim zaczniesz edytować pliki, wykonaj szybką diagnozę:

• Sprawdź inne strony: Jeśli na tym samym koncie hostingowym masz inne witryny (niekoniecznie na WordPressie), sprawdź, czy działają. Jeśli one również mają problemy, najprawdopodobniej jest to awaria po stronie dostawcy hostingu. Skontaktuj się z jego pomocą techniczną.
• Usuń plik .maintenance: Połącz się z serwerem przez FTP lub menedżer plików w hostingu i sprawdź, czy w głównym katalogu WordPressa (/public_html/ lub podobnym) znajduje się plik o nazwie .maintenance. Jeśli tak, usuń go. Plik ten jest tworzony podczas automatycznych aktualizacji i jego pozostawienie może powodować błędy.

Włącz tryb debugowania, aby poznać przyczynę

To najważniejszy krok diagnostyczny. Zamiast zgadywać, pozwól WordPressowi powiedzieć Ci, co jest nie tak.

1. Połącz się z serwerem przez FTP i otwórz plik wp-config.php.
2. Znajdź linię: define( 'WP_DEBUG', false );.
3. Zastąp ją poniższym fragmentem kodu. Pozwoli on na zapisywanie błędów do pliku, bez wyświetlania ich na stronie, co jest bezpieczniejsze. PHP// Włącza tryb debugowania define( 'WP_DEBUG', true ); // Zapisuje błędy do pliku /wp-content/debug.log define( 'WP_DEBUG_LOG', true ); // Ukrywa błędy na stronie (ważne na produkcyjnych witrynach) define( 'WP_DEBUG_DISPLAY', false );
4. Zapisz zmiany i odśwież swoją stronę (która nadal będzie biała).
5. Teraz przejdź do folderu /wp-content/ i poszukaj pliku debug.log. Otwórz go – znajdziesz w nim dokładny komunikat o błędzie, wskazujący na plik i linię kodu, która go powoduje. Najczęściej będzie to ścieżka do problematycznej wtyczki lub motywu.

Wyłącz wszystkie wtyczki (najczęstszy winowajca)

Jeśli logi z kroku 2 wskazują na wtyczkę lub nie wiesz, jak je odczytać, to jest najpewniejsza metoda.

1. Połącz się z serwerem przez FTP lub menedżer plików.
2. Przejdź do katalogu wp-content.
3. Znajdź folder plugins i zmień jego nazwę na plugins_deaktywowane.
4. Sprawdź, czy Twoja strona i panel admina działają. Jeśli tak, problemem była jedna z wtyczek.
5. Aby znaleźć winowajcę, zmień nazwę folderu z powrotem na plugins. Wejdź do panelu admina (Ustawienia -> Wtyczki, będą one zdezaktywowane) i włączaj je pojedynczo, aż strona ponownie przestanie działać.

Zmień motyw na domyślny

Jeśli wyłączenie wtyczek nie pomogło, problem może leżeć w aktywnym motywie.

1. Przez FTP przejdź do katalogu wp-content/themes.
2. Zmień nazwę folderu z Twoim aktywnym motywem (np. moj-motyw na moj-motyw-problem).
3. WordPress automatycznie aktywuje jeden z domyślnych motywów (np. Twenty Twenty-Four). Jeśli strona zadziała, oznacza to, że Twój motyw jest uszkodzony, niekompatybilny lub ma błąd w kodzie.

Zwiększ limit pamięci PHP

Bardzo częsta przyczyna, zwłaszcza na stronach z dużą liczbą wtyczek lub rozbudowanymi motywami.

1. W pliku wp-config.php dodaj następującą linię, tuż przed /* That's all, stop editing! */: PHPdefine('WP_MEMORY_LIMIT', '256M');
2. Jeśli to nie zadziała, limit może być narzucony przez hosting. Sprawdź ustawienia PHP w panelu swojego hostingu (np. cPanel, DirectAdmin) i tam poszukaj opcji memory_limit.

Wyczyść pamięć podręczną (cache)

Uszkodzony plik cache może powodować WSoD.

• Cache wtyczek: Jeśli używasz wtyczki do cachowania (np. LiteSpeed Cache, WP Rocket), połącz się przez FTP i usuń zawartość folderu wp-content/cache.
• Cache po stronie serwera: Niektórzy dostawcy hostingu oferują własny system cache. Poszukaj opcji „Wyczyść cache” w panelu hostingowym.

Sprawdź uprawnienia plików i folderów

Nieprawidłowe uprawnienia mogą uniemożliwić serwerowi odczyt plików. Standardowe uprawnienia to:

• 755 dla wszystkich folderów.
• 644 dla wszystkich plików.

Możesz je sprawdzić i poprawić za pomocą klienta FTP (kliknij prawym przyciskiem na plik/folder -> Uprawnienia pliku).

Wgraj na nowo pliki rdzenia WordPressa

Jeśli podejrzewasz, że kluczowe pliki WordPressa są uszkodzone, możesz je bezpiecznie nadpisać.

1. Pobierz najnowszą wersję WordPressa ze strony wordpress.org.
2. Rozpakuj archiwum ZIP na swoim komputerze.
3. Połącz się z serwerem przez FTP i usuń foldery wp-admin oraz wp-includes.
4. Wgraj na serwer świeże foldery wp-admin i wp-includes z pobranego archiwum. Uwaga: Nie usuwaj folderu wp-content ani pliku wp-config.php, ponieważ zawierają one Twoje treści i konfigurację!

Jak zapobiegać „Białemu Ekranowi Śmierci” w przyszłości?

• Regularne kopie zapasowe: To absolutna podstawa. Zawsze miej aktualną kopię zapasową plików i bazy danych.
• Używaj środowiska testowego (staging): Przed wdrożeniem aktualizacji wtyczek, motywów czy samego WordPressa na żywej stronie, przetestuj je na kopii deweloperskiej.
• Instaluj tylko zaufane wtyczki i motywy: Wybieraj rozszerzenia z dobrymi opiniami, regularnie aktualizowane i od sprawdzonych autorów.
• Dbaj o aktualizacje: Regularnie aktualizuj rdzeń WordPressa, wtyczki i motywy, ale rób to świadomie (najlepiej na wersji testowej).

Pamiętaj, aby po rozwiązaniu problemu wyłączyć tryb debugowania w pliku wp-config.php, zmieniając true z powrotem na false.