Biała strona w WordPress – co oznacza i jak ją naprawić?

Biała strona w WordPress, znana jako White Screen of Death, to błąd krytyczny, który na szczęście w większości przypadków można naprawić samodzielnie w 1-2 godziny. Zazwyczaj jego źródłem jest konfliktowa wtyczka lub zbyt mały limit pamięci PHP, a sam problem nie oznacza utraty danych. Poznaj sprawdzone kroki, które pozwolą Ci zdiagnozować przyczynę i szybko przywrócić działanie witryny.

Co to jest biała strona śmierci (WSOD) w WordPress?

Biała strona śmierci, znana jako White Screen of Death (WSOD), to krytyczny błąd w systemie WordPress, który objawia się pustym, białym ekranem zamiast właściwej zawartości witryny. Charakterystyczną cechą WSOD jest brak jakichkolwiek komunikatów czy kodów, co znacznie utrudnia diagnozę problemu. Czasem może być to ukryta forma błędu serwera 500, jednak najczęściej źródło znajduje się bezpośrednio w WordPressie. Błąd może wystąpić zarówno na publicznej stronie, jak i w panelu administracyjnym (/wp-admin), całkowicie blokując dostęp do zarządzania witryną.

Przyczyną białej strony jest nagłe zatrzymanie wykonywania skryptu PHP, najczęściej na skutek konfliktu kodu między wtyczkami lub motywem albo wskutek zbyt niskiego limitu pamięci PHP na serwerze. Mimo alarmującego widoku, WSOD nie powoduje utraty danych – wszystkie wpisy, strony, zdjęcia i ustawienia w bazie pozostają bezpieczne. Problem dotyczy działania aplikacji, a nie trwałej awarii serwera czy uszkodzenia danych.

Główne przyczyny białej strony – od wtyczek po serwer

Biała strona najczęściej wynika z problemów po stronie WordPressa, a nie samego serwera. Najważniejsze przyczyny to konflikty w kodzie wtyczek lub motywów oraz niewystarczające zasoby serwera, szczególnie niski limit pamięci PHP. Sporadyczne pojawienie się białej strony może wskazywać na chwilowe przeciążenie serwera, np. z powodu nagłego wzrostu ruchu.

Do najczęstszych przyczyn błędu WSOD należą:

• Konflikt wtyczek lub motywu – jest to podstawowy powód występowania błędu. Problem pojawia się, gdy nowa lub zaktualizowana wtyczka zawiera kod niezgodny z innymi komponentami strony, aktywnym motywem lub wersją WordPressa. Często problem powoduje też błędna edycja pliku functions.php motywu, co wywołuje krytyczny błąd PHP, który natychmiast zatrzymuje ładowanie witryny.
• Przekroczenie limitu pamięci PHP – hostingi często ustalają domyślny limit pamięci na np. 64 MB. Dla nowoczesnych stron korzystających z builderów (np. Elementor) lub sklepów WooCommerce minimalny zalecany limit to 256 MB. Zbyt niska wartość skutkuje błędem przy większym zapotrzebowaniu na zasoby.
• Chwilowe przeciążenie serwera – gdy biały ekran pojawia się sporadycznie i znika, może to oznaczać, że zasoby serwera są wyczerpane. Rosnące obciążenia, na przykład generowane przez wtyczki AI, zwiększają ryzyko pojawiania się tego problemu, szczególnie na słabszych planach hostingowych.

Jak naprawić białą stronę w WP? Instrukcja krok po kroku

Naprawa WSOD polega na systematycznym wykluczaniu potencjalnych przyczyn, zaczynając od najczęstszych. Do większości czynności diagnostycznych potrzebny jest dostęp do plików witryny przez FTP (np. programem FileZilla) oraz dane logowania do serwera. Proste naprawy nie wymagają zaawansowanej wiedzy, lecz metodycznego podejścia.

Proces diagnozy przebiega według ustalonej kolejności, co pozwala szybko znaleźć źródło błędu. Oto mapa drogowa naprawy WSOD:

1. Sprawdzenie konfliktu wtyczek lub motywu – najważniejszy i pierwszy krok, bo to najczęstsza przyczyna.
2. Zwiększenie limitu pamięci PHP – jeśli wyłączenie dodatków nie pomaga, trzeba zweryfikować zasoby serwera.
3. Włączenie trybu debugowania – pozwoli wyświetlić ukryte komunikaty PHP, które zamiast białej strony pokazują błędy.
4. Weryfikacja plików rdzenia i bazy danych – ostateczne kroki, jeśli wcześniejsze nie przyniosą efektu.

Krok 1: Zidentyfikuj problem z wtyczką lub motywem

Najpierw należy sprawdzić, czy błąd powodują wtyczki. Połącz się z serwerem przez FTP i zmień nazwę katalogu /wp-content/plugins/ na np. /wp-content/plugins_old/. Ta operacja natychmiast wyłączy wszystkie rozszerzenia.

Jeśli po tym stronie lub w panelu administracyjnym wszystko działa, to wina leży w jednej z wtyczek. Przywróć oryginalną nazwę folderu, zaloguj się do kokpitu WordPress i włączaj wtyczki pojedynczo, aż błąd się powtórzy – wtedy poznasz winowajcę. Jeśli wyłączenie wtyczek nie pomaga, spróbuj przełączyć się na domyślny motyw (np. Twenty Twenty-Four) i sprawdź, czy problem ustąpił.

Krok 2: Zwiększ limit pamięci PHP w WordPressie

Jeżeli deaktywacja wtyczek nie rozwiązała problemu, sprawdź limit pamięci PHP. Połącz się z serwerem i otwórz do edycji plik wp-config.php w głównym katalogu WordPressa. Dodaj poniższą linię najlepiej tuż przed komentarzem:

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

Ustawia ona limit na 256 MB, co zazwyczaj jest wystarczające. Alternatywnie można podnieść ten limit w pliku .htaccess, jeśli WordPress tego wymaga.

Krok 3: Uruchom tryb debugowania, by znaleźć błędy

Gdy problem dalej występuje, włącz tryb debugowania w WordPressie, by zobaczyć dokładne błędy PHP. Znowu edytuj plik wp-config.php i dodaj dwie linie:

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

Pierwsza wartość pozwoli na wyświetlanie błędów zamiast białej strony, a druga zapisze je w pliku debug.log w katalogu /wp-content/. Analiza tego pliku precyzyjnie wskaże, która wtyczka, motyw lub linia kodu powoduje awarię.

Krok 4: Zaawansowane metody – pliki core i baza danych

Jeśli nic nie pomaga, należy ręcznie nadpisać pliki rdzenia WordPressa, pobierając najnowszą, czystą wersję systemu. Za pomocą FTP zamień katalogi /wp-admin/ i /wp-includes/ na serwerze. Nie usuwaj folderu /wp-content/ i pliku wp-config.php, bo zawierają one dane i konfigurację witryny.

W przypadku podejrzenia uszkodzonej bazy danych, użyj phpMyAdmin dostępnego w panelu hostingu. Po wyborze bazy możesz wykonać polecenie REPAIR TABLE na jej tabelach, aby naprawić drobne uszkodzenia struktury.

Ile czasu zajmie naprawa i kiedy wezwać specjalistę?

Naprawa błędu białej strony trwa zwykle od 1–2 godzin w prostych przypadkach do nawet 24 godzin, gdy problem jest bardziej skomplikowany. Najszybciej rozwiązywalne są konflikty wtyczek lub motywów, zwłaszcza gdy masz dostęp do serwera FTP. Wtedy wystarczy zmiana nazwy folderu i metodyczne testowanie. Złożone awarie, takie jak uszkodzenie plików rdzenia czy konieczność naprawy bazy danych, wymagają więcej czasu i doświadczenia.

Warto skorzystać z pomocy specjalisty, gdy:

• nie masz dostępu do plików przez FTP,
• hosting blokuje edycję kluczowych plików (np. wp-config.php),
• Twoja witryna jest biznesowa lub sklepowa (np. WooCommerce) i każdy przestój generuje straty.

Szybka reakcja profesjonalisty minimalizuje negatywne skutki awarii.

Jak zapobiegać błędom WSOD w przyszłości?

Zapobieganie WSOD jest znacznie prostsze i tańsze niż naprawa. Podstawą stabilności strony są dobre praktyki utrzymania i świadome zarządzanie zasobami.

Aby skutecznie chronić witrynę, warto wdrożyć następujące działania:

• Regularne kopie zapasowe – twórz pełen backup plików i bazy danych przed każdą aktualizacją WordPressa, wtyczek lub motywu. To najważniejszy krok, którego pominięcie najczęściej prowadzi do problemów.
• Stałe aktualizacje – zachowuj wszystkie elementy strony w najnowszych wersjach. Najlepiej testuj je na środowisku stagingowym, zanim wdrożysz na żywo. Aktualizacje eliminują luki bezpieczeństwa i konflikty kompatybilności.
• Optymalizacja i porządkowanie witryny – usuwaj nieużywane wtyczki i motywy, aby zmniejszyć złożoność. Konfiguruj cache (np. WP Super Cache) i dbaj o kompresję obrazów, co odciąża serwer.
• Monitorowanie zasobów i błędów – obserwuj zużycie CPU, RAM i dysku, szczególnie na tanich hostingach. Wtyczka Query Monitor umożliwi na bieżąco wykrywać problemy z wydajnością i błędy PHP, zanim doprowadzą do awarii.

Dzięki konsekwentnemu stosowaniu tych zasad unikniesz sytuacji prowadzących do WSOD i poprawisz stabilność swojej witryny.