Czym jest biały ekran WordPress (WSOD)?
Biały ekran śmierci WordPress to sytuacja, w której przeglądarka wyświetla całkowicie pustą, białą stronę, bez treści, bez komunikatu o błędzie, bez paska nawigacyjnego. Może dotyczyć całej witryny lub tylko panelu administracyjnego (/wp-admin). Przyczyną jest zazwyczaj błąd krytyczny PHP, który WordPress "połyka" zamiast pokazać szczegóły. Dobra wiadomość: dane w bazie są bezpieczne, a problem można usunąć bez utraty treści.
7 najczęstszych przyczyn białego ekranu WordPress
1. Konflikt lub błąd wtyczki
Zdecydowanie najczęstsza przyczyna. Nowo zainstalowana lub zaktualizowana wtyczka generuje błąd PHP, który blokuje działanie całego WordPressa. Szczególnie narażone są wtyczki cache'ujące, page-buildery (Elementor, Divi) i wtyczki ingerujące w nagłówki HTTP.
2. Wadliwy lub niekompatybilny motyw
Błąd w pliku functions.php aktywnego motywu to pewna przepustka do białego ekranu. Nawet pojedynczy brakujący nawias lub nieobsługiwana funkcja PHP po aktualizacji serwera wystarczy, żeby strona przestała się ładować.
3. Wyczerpany limit pamięci PHP (memory_limit)
WordPress potrzebuje pamięci RAM do uruchomienia każdego żądania. Gdy wartość memory_limit jest zbyt niska (np. domyślne 32 MB na tańszych hostingach), bardziej rozbudowane strony po prostu się nie ładują, efektem jest właśnie biały ekran.
4. Błąd składni PHP
Ręczna edycja pliku wp-config.php, functions.php lub jakiegokolwiek pliku PHP i przypadkowe usunięcie średnika, nawiasu czy cudzysłowu, to natychmiastowy WSOD. PHP nie wybaczy nawet jednego znaku literówki.
5. Uszkodzony plik rdzenia WordPress
Niepełna aktualizacja WordPressa, atak malware nadpisujący pliki core lub błąd transferu FTP mogą uszkodzić pliki w folderach /wp-includes/ lub /wp-admin/. W takiej sytuacji sam WordPress nie może się załadować.
6. Uszkodzony plik .htaccess
Nieprawidłowe reguły w pliku .htaccess (np. po instalacji wtyczki do bezpieczeństwa lub ręcznej edycji) mogą powodować błąd serwera skutkujący białym ekranem, szczególnie na serwerach Apache.
7. Brak miejsca na dysku lub inodes
Gdy hosting ma pełny dysk lub wyczerpany limit inodes (liczby plików), PHP nie może zapisywać plików tymczasowych, logów ani sesji. Efektem może być biały ekran lub błąd 500. Sprawdź panel hostingu, zakładkę statystyk dysku.
Jak naprawić biały ekran WordPress, krok po kroku
Krok 1: Włącz tryb debugowania WP_DEBUG
Otwórz plik wp-config.php przez FTP lub menedżer plików hostingu i zmień lub dodaj poniższe linie tuż przed /* That's all, stop editing! */:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Błędy będą teraz zapisywane do pliku wp-content/debug.log. Otwórz ten plik, znajdziesz w nim dokładną nazwę pliku i linię, w której wystąpił błąd. To najszybsza droga do znalezienia winowajcy.
Krok 2: Dezaktywuj wszystkie wtyczki przez FTP
Przez FTP (lub menedżer plików) wejdź do folderu wp-content/ i zmień nazwę folderu plugins na plugins_disabled. Odśwież stronę, jeśli białego ekranu nie ma, problem leży w jednej z wtyczek. Przywróć oryginalną nazwę folderu, a następnie wchodź do środka i zmieniaj nazwy folderów poszczególnych wtyczek po jednej, aż znajdziesz tę, która powoduje błąd.
Krok 3: Przełącz na domyślny motyw WordPress
Jeśli wyłączenie wtyczek nie pomogło, przyczyną może być motyw. Przez FTP przejdź do wp-content/themes/ i zmień nazwę folderu aktywnego motywu. WordPress automatycznie przełączy się na motyw domyślny (np. twentytwentyfive). Jeśli strona wróci, problem leży w motywie, zazwyczaj w pliku functions.php.
Krok 4: Zwiększ limit pamięci PHP
W pliku wp-config.php dodaj poniższą linię:
define( 'WP_MEMORY_LIMIT', '256M' );Alternatywnie możesz to zrobić w pliku .htaccess (na hostingach Apache):
php_value memory_limit 256MNa hostingach współdzielonych (home.pl, cyberFolks, LH.pl, Hostinger) limit można też zmienić w panelu klienta w ustawieniach PHP.
Krok 5: Zresetuj plik .htaccess
Przez FTP zmień nazwę pliku .htaccess w katalogu głównym na .htaccess_old. WordPress będzie działał bez niego (z ograniczonymi permalinkami). Jeśli strona wróci, wygeneruj nowy .htaccess wchodząc do Ustawienia → Bezpośrednie odnośniki w panelu admina i klikając "Zapisz zmiany".
Krok 6: Skorzystaj z trybu odzyskiwania WordPress
Od wersji WordPress 5.2 działa wbudowany tryb recovery. Gdy WordPress wykryje błąd krytyczny, wysyła e-mail na adres administratora z unikalnym linkiem do panelu admina. Link ten otwiera /wp-admin/ z wyłączonymi wtyczkami i motywem, co pozwala bezpiecznie dezaktywować problematyczny element bez potrzeby FTP.
Jeśli na tym etapie nadal nie wiesz co jest przyczyną, możliwe jest głębsze uszkodzenie instalacji, zainfekowane pliki, uszkodzona baza danych lub problem po stronie serwera. W takich przypadkach warto sięgnąć po profesjonalną naprawę błędów WordPress. Jeśli podejrzewasz atak hakerski, koniecznie sprawdź ofertę usuwania malware WordPress, WSOD bywa jednym z objawów infekcji złośliwym oprogramowaniem. Warto też zapoznać się z poradnikiem o błędzie 500 WordPress, który często ma podobne przyczyny.
Kiedy lepiej zadzwonić do specjalisty
Jeśli po przejściu powyższych kroków biały ekran WordPress wciąż się utrzymuje, debug.log pokazuje błędy, których nie rozumiesz, lub nie masz dostępu do FTP, nie trać czasu na zgadywanie. Zajmuję się takimi przypadkami na co dzień i zazwyczaj dopytuję o problem, diagnozuję i naprawiam w ciągu jednej godziny. Zadzwoń: 577 020 415, reakcja w 1h, bezpłatna wstępna diagnoza, rozliczam co 15 minut.