Biały ekran WordPress (White Screen of Death) – jak naprawić?

Czym jest White Screen of Death w WordPress?

White Screen of Death (WSOD) to potoczna nazwa problemu, kiedy strona WordPress wyświetla tylko pustą, białą stronę — bez żadnego komunikatu błędu, bez treści, bez paska admina. Problem może dotyczyć całej strony, tylko frontendu albo tylko panelu administracyjnego.

Dobra wiadomość: WSOD prawie zawsze jest naprawialny bez utraty danych. Zła: musisz działać po ciemku, bo WordPress nie mówi Ci co się stało. Poniżej znajdziesz wszystkie możliwe przyczyny i ich rozwiązania — sprawdzaj je po kolei.

Przyczyna 1 – Błąd w wtyczce lub motywie (najczęstsza)

Nowo zainstalowana lub zaktualizowana wtyczka albo motyw zawiera błąd PHP, który zatrzymuje działanie całego WordPressa. To zdecydowanie najczęstsza przyczyna białego ekranu.

Rozwiązanie przez FTP/menedżer plików: Wejdź na serwer przez FTP lub panel hostingu. Przejdź do katalogu wp-content/plugins/ i zmień nazwę folderu ostatnio zainstalowanej lub zaktualizowanej wtyczki (np. dodaj -disabled na końcu). Jeśli strona wróci — znalazłeś winowajcę. Możesz też zmienić nazwę całego folderu plugins/ na plugins-disabled/, żeby dezaktywować wszystkie naraz.

Rozwiązanie dla motywu: W katalogu wp-content/themes/ zmień nazwę aktywnego motywu. WordPress automatycznie przełączy się na domyślny motyw (Twenty Twenty-Four).

Przyczyna 2 – Wyczerpany limit pamięci PHP

WordPress ma domyślnie ustawiony limit pamięci PHP (zazwyczaj 32 MB lub 64 MB), który jest za mały dla dużych stron z wieloma wtyczkami. Kiedy skrypt przekroczy limit, PHP kończy działanie bez komunikatu błędu — stąd biały ekran.

Rozwiązanie: Dodaj lub zmodyfikuj linię w pliku wp-config.php:

define( 'WP_MEMORY_LIMIT', '256M' );

Jeśli to nie wystarczy, podnieś limit również po stronie serwera w pliku php.ini lub przez panel hostingu (szukaj opcji „PHP Memory Limit"). Standardowo 256 MB powinno wystarczyć dla większości stron.

Przyczyna 3 – Uszkodzony plik wp-config.php lub .htaccess

Przypadkowe usunięcie znaku, błędna edycja lub złośliwy kod w wp-config.php może wywołać biały ekran już na etapie ładowania WordPressa. Podobnie błędny .htaccess powoduje problemy z routingiem.

Rozwiązanie dla .htaccess: Zmień nazwę pliku .htaccess na .htaccess-backup i sprawdź czy strona wróci. Jeśli tak — wygeneruj nowy plik przez panel WordPress (Ustawienia → Bezpośrednie odnośniki → Zapisz zmiany).

Rozwiązanie dla wp-config.php: Pobierz świeżą kopię pliku wp-config-sample.php z oficjalnej paczki WordPress i porównaj ze swoim plikiem. Szczególnie sprawdź czy nie ma zbędnych znaków przed <?php lub po ostatniej linii.

Przyczyna 4 – Błąd składni w functions.php

Edycja pliku functions.php motywu przez Panel → Edytor plików (lub ręcznie przez FTP) przy przypadkowym błędzie składni PHP natychmiast wywoła biały ekran. Nawet jeden brakujący średnik wystarczy.

Rozwiązanie: Przez FTP otwórz wp-content/themes/[nazwa-motywu]/functions.php i cofnij ostatnią zmianę. Jeśli nie wiesz co zmieniłeś, pobierz czystą kopię motywu i zastąp plik.

Przyczyna 5 – Włącz tryb debugowania, żeby zobaczyć błąd

Jeśli żadna z powyższych metod nie pomogła, włącz debugowanie WordPress, żeby zobaczyć konkretny komunikat błędu. W pliku wp-config.php znajdź i zmień:

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

Błędy zostaną zapisane w pliku wp-content/debug.log. Otwórz go i znajdź ostatni wpis — zazwyczaj od razu wskażuje konkretny plik i linię kodu, gdzie wystąpił problem. Po rozwiązaniu koniecznie wyłącz debugowanie (WP_DEBUG false).

Przyczyna 6 – Problem z bazą danych

Jeśli widzisz komunikat „Error establishing a database connection" zamiast białego ekranu — problem leży w połączeniu z bazą danych. Sprawdź dane dostępowe w wp-config.php (nazwa bazy, użytkownik, hasło, host) i porównaj z danymi w panelu hostingu. Ten błąd jest szczególnie częsty po migracji strony na nowy hosting.

Jeśli mimo wszystkich kroków strona nadal nie działa, sprawdź też jak naprawić błąd 500 w WordPress — objawy bywają podobne, przyczyny różne. Jeśli strona została zaatakowana, przeczytaj nasz przewodnik po odwirusowaniu WordPressa.