Biały ekran w WordPressie (White Screen of Death) – jak go naprawić?

Wchodzisz na adres swojej strony internetowej lub próbujesz zalogować się do panelu administracyjnego /wp-admin/, a zamiast treści wita Cię całkowicie pusty, biały ekran?

To słynny Biały Ekran Śmierci (ang. White Screen of Death – WSoD). Brak jakiegokolwiek komunikatu o błędzie, nagłówka czy stopki sprawia, że usterka ta wydaje się szczególnie groźna.

Spokojnie. W 99% przypadków biały ekran w WordPressie nie oznacza usunięcia bazy danych ani skasowania plików strony. To po prostu dyskretna reakcja serwera na krytyczny błąd skryptu PHP, który ze względów bezpieczeństwa uniemożliwił wygenerowanie widoku strony.

W tym poradniku dowiesz się, z czego wynika ta usterka oraz jak krok po kroku odzyskać dostęp do witryny.

Dlaczego w WordPressie pojawia się biały ekran?

W przeciwieństwie do Błędu 500 czy Błędu Połączenia z Bazą Danych, WSoD zazwyczaj nie wyświetla żadnej treści, ponieważ obsługa błędów PHP na Twoim serwerze jest wyłączona (co jest standardową i dobrą praktyką na serwerach produkcyjnych).

Najczęstsze przyczyny powstawania białego ekranu to:

1. Przekroczenie limitu pamięci PHP (memory_limit) – skrypt wtyczki lub motywu potrzebował więcej pamięci RAM, niż przydzielił mu hosting.
2. Konflikt po aktualizacji wtyczki lub motywu – nowo zainstalowany dodatek zawiera błąd w kodzie lub jest niekompatybilny z wersją PHP na serwerze.
3. Błąd składniowy w pliku functions.php – przypadkowe usunięcie średnika lub nawiasu podczas ręcznej edycji motywu.
4. Niedokończona automatyczna aktualizacja – przerwanie procesu podnoszenia wersji WordPressa lub wtyczki.

Jak naprawić biały ekran w WordPressie krok po kroku?

Zanim przejdziemy do naprawy, pobierz kopię zapasową plików strony przez FTP.

Krok 1: Włącz tryb debugowania (WP_DEBUG)

Zamiast patrzeć na pusty ekran, zmusimy WordPressa do wyświetlenia konkretnej informacji o błędzie.

1. Połącz się z serwerem przez FTP lub Menedżer Plików w panelu hostingu.
2. Otwórz plik wp-config.php znajdujący się w głównym katalogu strony.
3. Odszukaj linijkę define('WP_DEBUG', false); i zamień ją na:

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

4. Odśwież stronę. Zamiast białego ekranu zobaczysz komunikat o błędzie (np. Fatal error: Uncaught Error...), w którym podana będzie dokładna ścieżka do pliku oraz nazwa wtyczki wywołującej awarię.

Ważne: Po usunięciu usterki pamiętaj, aby przywrócić wartość false dla WP_DEBUG_DISPLAY, by nie pokazywać błędów technicznym odwiedzającym.

Krok 2: Wyłączenie wszystkich wtyczek przez FTP

Jeśli błąd wskazuje na wtyczkę lub nie masz możliwości włączenia trybu debugowania, wyłączymy wszystkie wtyczki jednocześnie.

1. Na serwerze FTP przejdź do katalogu /wp-content/.
2. Zmień nazwę folderu plugins na plugins_old.
3. Odśwież stronę.

Jeśli witryna zaczęła działać (choć bez funkcji wtyczek), masz pewność, że winna była jedna z nich. Przywróć nazwę folderu na plugins, wejdź do środka i zmieniaj nazwy poszczególnych подfolderów (np. woocommerce_old), aby precyzyjnie namierzyć uszkodzony dodatek.

Krok 3: Zwiększenie limitu pamięci PHP

Jeśli biały ekran pojawia się tylko w niektórych miejscach (np. podczas zapisywania posta lub w panelu administracyjnym), przyczyna leży w braku pamięci RAM dla skryptów.

Otwórz plik wp-config.php i tuż przed linijką /* That's all, stop editing! Happy publishing. */ dopisz:

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

Jeśli hosting na to pozwala, limit pamięci przydzielony dla WordPressa zostanie podniesiony do 256 MB, co wyeliminuje problem.

Krok 4: Przywrócenie domyślnego motywu

Jeśli usterka wystąpiła po modyfikacji wyglądu strony lub aktualizacji motywu:

1. Przejdź na serwerze FTP do katalogu /wp-content/themes/.
2. Zmień nazwę folderu aktywnego motywu (np. twentytwentyfour na twentytwentyfour_old).
3. WordPress automatycznie wykryje brak aktywnego motywu i przełączy się na domyślny motyw systemowy, przywracając działanie witryny.

Co zrobić, gdy strona nadal się nie ładuje?

Jeśli żaden z powyższych kroków nie przyniósł rezultatu, problem może leżeć w uszkodzeniu plików rdzenia oprogramowania lub w pamięci podręcznej serwera (Cache).

W takiej sytuacji warto nadpisać katalogi wp-admin oraz wp-includes czystymi plikami pobranymi z oficjalnej strony pl.wordpress.org.

Potrzebujesz pomocy z naprawą witryny?

Diagnostyka błędów PHP i praca z plikami konfiguracyjnymi bez doświadczenia może zająć wiele cennych godzin.

Jeśli zależy Ci na natychmiastowym przywróceniu działania strony firmowej lub sklepu:

Skorzystaj z pomocy specjalistów. W fix-web.pl szybko diagnozujemy i usuwamy błąd białego ekranu (WSoD) oraz zabezpieczamy witryny przed ponownymi awariami.

• Szybka diagnoza: Identyfikujemy przyczyny błędu w kilkanaście minut.
• Przejrzyste warunki: Wyznaczasz budżet i znasz cenę przed rozpoczęciem prac.
• Gwarancja 100%: Płacisz tylko za skutecznie naprawioną stronę.

👉 Zgłoś awarię do darmowej wyceny – odpisujemy w ciągu max 2 godzin!

Najczęściej zadawane pytania (FAQ)