Wchodzisz na swoją stronę, a tam nic. Biała pustka, czasem jedno zdanie o „krytycznym błędzie”. Spokojnie: tak zwany biały ekran śmierci (WSOD — white screen of death) wygląda groźnie, ale w większości przypadków treść strony jest cała i zdrowa — to tylko kod PHP wywrócił się w trakcie budowania widoku. Poniżej ścieżka diagnozy od najczęstszej przyczyny do najrzadszej. Zanim zaczniesz: jeśli masz świeżą kopię zapasową, nic nie stracisz. Jeśli nie masz — nie dotykaj nic „na ślepo” i zacznij od kroku 1.
Skąd się bierze biały ekran
W praktyce za 9 na 10 białych ekranów odpowiada jedno z czterech: konflikt lub błąd wtyczki (najczęściej po aktualizacji), błąd w motywie, wyczerpany limit pamięci PHP albo niekompatybilna wersja PHP na hostingu. Rzadsze przyczyny to uszkodzone pliki rdzenia, uszkodzona baza danych i złośliwy kod.
Krok 0: wyklucz oczywistości (2 minuty)
Otwórz stronę w trybie incognito i sprawdź panel administracyjny pod adresem twojadomena.pl/wp-admin. Jeśli panel działa, a biała jest tylko strona — winowajcą jest niemal na pewno motyw lub wtyczka. Jeśli WordPress wysłał Ci maila „Twoja witryna ma problem techniczny” — kliknij link do trybu odzyskiwania, wskaże winną wtyczkę palcem.
Krok 1: włącz tryb debugowania
Połącz się z serwerem przez FTP lub menedżer plików hostingu i w pliku wp-config.php, nad linią „That’s all, stop editing”, dopisz:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Odśwież stronę i zajrzyj do pliku wp-content/debug.log. Ostatnie linie zwykle wskazują plik, który powoduje błąd — jeśli ścieżka zawiera „plugins/nazwa-wtyczki”, masz winowajcę. Po naprawie wyłącz debugowanie, zmieniając true na false.
Krok 2: wyłącz wtyczki przez FTP
Nie masz dostępu do panelu, więc wtyczki wyłączysz z poziomu plików:
- W katalogu wp-content zmień nazwę folderu „plugins” na „plugins-off”. To wyłącza wszystkie wtyczki naraz.
- Odśwież stronę. Działa? Przyczyną była wtyczka.
- Przywróć nazwę „plugins”, a następnie zmieniaj nazwy folderów pojedynczych wtyczek (np. „nazwa-wtyczki-off”), zaczynając od ostatnio aktualizowanych — aż znajdziesz winną.
- Winną wtyczkę zaktualizuj, a jeśli błąd wraca — poszukaj zamiennika. Wtyczka, która wywraca stronę, nie zasługuje na drugą szansę.
Krok 3: przełącz motyw
Jeśli wtyczki są niewinne, zmień przez FTP nazwę folderu aktywnego motywu w wp-content/themes — WordPress automatycznie przełączy się na motyw domyślny. Strona wstała? Problem leży w motywie (najczęściej w pliku functions.php po ręcznych zmianach lub nieudanej aktualizacji).
Krok 4: limit pamięci i wersja PHP
Duże strony potrafią przekroczyć domyślny limit pamięci. W wp-config.php dopisz:
define( 'WP_MEMORY_LIMIT', '256M' );Sprawdź też w panelu hostingu wersję PHP: WordPress w 2026 roku najlepiej czuje się na PHP 8.2–8.3. Zbyt stara — ale i zbyt świeżo zmieniona — wersja PHP to częsta przyczyna nagłych awarii; przełączenie o jedną wersję w dół bywa szybkim testem.
Krok 5: cięższe przypadki
Jeśli powyższe nie pomogło, zostają: nadpisanie plików rdzenia świeżą kopią WordPressa (bez katalogu wp-content!), naprawa bazy danych i skan pod kątem malware — biały ekran bywa objawem włamania. Na tym etapie liczy się doświadczenie i chłodna głowa, bo nieumiejętna „naprawa” potrafi zamienić godzinną usterkę w utratę danych.
Nie chcesz w to wchodzić?
Rozumiemy — od tego jesteśmy. W ramach usługi migracje i naprawy przywracamy strony do życia zwykle w 24–48 godzin, a w abonamencie opieki nad stroną aktualizujemy wtyczki po testach na kopii, robimy codzienny backup i wyłapujemy problemy, zanim zobaczy je pierwszy klient. Bo najlepszy biały ekran to ten, który nigdy się nie wyświetlił.