Internet Zona O internecie, w internecie

Biały ekran w WordPressie (tzw. white screen of death) najczęściej oznacza błąd PHP, konflikt wtyczek, problem z motywem albo wyczerpanie pamięci serwera – w większości przypadków da się go samodzielnie naprawić, krok po kroku.

Czym jest biały ekran w WordPressie?

Treść

Biały ekran w WordPressie to sytuacja, gdy zamiast strony (frontu) lub panelu administratora widzisz całkowicie pustą, białą stronę, bez treści i komunikatu o błędzie.

Najczęściej jest to efekt krytycznego błędu PHP, którego WordPress nie wyświetla, jeśli tryb debugowania jest wyłączony.

Oto najczęstsze symptomy, które pozwalają rozpoznać problem:

  • biały ekran tylko na stronie głównej,
  • biały ekran na całej witrynie, także w panelu /wp-admin,
  • biały ekran przy próbie edycji wpisu lub pracy w edytorze (np. Elementor),
  • czasem komunikat „Wystąpił błąd krytyczny na tej stronie” zamiast czystej bieli.

Najczęstsze przyczyny białego ekranu w WordPressie

Według polskich poradników hostingowych i blogów technicznych, biały ekran zwykle ma jedną z poniższych przyczyn:

  • konflikt lub błąd w wtyczce (nowa wtyczka, aktualizacja lub źle napisany dodatek),
  • błąd w motywie (szablonie) – np. w pliku functions.php lub innym pliku PHP w motywie,
  • zbyt niski limit pamięci PHP (konstanta WP_MEMORY_LIMIT) – skrypt wyczerpuje dostępny limit i kończy się błędem, którego nie widać bez debugowania,
  • błąd składniowy (syntax error) w kodzie – np. po ręcznej edycji plików motywu lub wtyczek,
  • problemy z cache (pamięcią podręczną) – źle działający plugin cache, CDN lub serwerowy mechanizm buforowania,
  • uszkodzony plik .htaccess lub błędne reguły przekierowań,
  • nieudana automatyczna aktualizacja WordPressa, motywu lub wtyczki (częściowo podmienne pliki),
  • problemy po stronie hostingu – np. ograniczenia zasobów, błędy konfiguracji PHP, wersja PHP niezgodna z wtyczką/motywem.

W większości przypadków wystarczy analiza logów, tymczasowe wyłączenie wtyczek/motywu i ewentualne zwiększenie pamięci, aby przywrócić stronę do działania.

Zanim zaczniesz – przygotowanie i zasady bezpieczeństwa

Przed rozpoczęciem naprawy zastosuj poniższe wskazówki:

  1. Wyciągnij kopię zapasową (backup)

    Jeśli masz dostęp do panelu hostingu, zrób kopię plików i bazy danych lub użyj wtyczki backupowej, jeśli jeszcze działa. W najgorszym razie potrzebne będzie przywrócenie witryny z kopii zapasowej.

  2. Przygotuj dostęp techniczny

    Do naprawy białego ekranu zwykle potrzebny jest:

    • dostęp do panelu hostingu (menedżer plików, logi błędów),
    • dostęp przez FTP/SFTP do plików strony (wp-content, wp-config.php, .htaccess),
    • jeśli to możliwe – dostęp do panelu WordPressa (/wp-admin), choć często jest on również „biały”.

  3. Nie panikuj – działaj krok po kroku

    Kluczowe jest systematyczne wykluczanie przyczyn: najpierw wtyczki, potem motyw, następnie pamięć i konfiguracja serwera.

Krok 1 – włącz tryb debugowania WordPressa

Najważniejszy krok diagnostyczny to włączenie trybu debugowania, który zapisze szczegóły błędów do logu.

Jak włączyć debugowanie w wp-config.php

  1. Zaloguj się na serwer (FTP/SFTP lub menedżer plików w hostingu).
  2. Otwórz plik wp-config.php w katalogu głównym WordPressa.
  3. Znajdź linię w pliku konfiguracyjnym i porównaj z poniższym przykładem:

define('WP_DEBUG', false);

  1. Zastąp ją poniższym kodem (lub dodaj go przed komentarzem „/* That’s all, stop editing! */”):

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

Co oznaczają poszczególne ustawienia:

  • WP_DEBUG – włącza tryb debugowania;
  • WP_DEBUG_LOG – zapisuje błędy do pliku wp-content/debug.log;
  • WP_DEBUG_DISPLAY ustawione na false – komunikaty błędów nie są wyświetlane użytkownikom na stronie, ale są logowane.
  1. Zapisz plik i odśwież stronę z białym ekranem, aby wygenerować wpisy w logu błędów.

Gdzie szukać informacji o błędach?

Sprawdź plik wp-content/debug.log (błędy WordPressa i wtyczek/motywów) oraz logi serwera w panelu hostingu (np. „Error logs” – błędy PHP, nazwy plików, wtyczek i komunikaty typu „Fatal error”).

Jeśli w logach widzisz nazwę wtyczki, motywu lub konkretnego pliku PHP, od razu wiesz, gdzie skierować dalszą diagnozę.

Krok 2 – wyłącz wszystkie wtyczki

Najczęstszy winowajca białego ekranu to wtyczka – zwłaszcza świeżo zainstalowana lub właśnie zaktualizowana.

Jeśli masz dostęp do panelu WordPress

  1. Zaloguj się do /wp-admin (jeśli nie jest biały).
  2. Przejdź do zakładki Wtyczki.
  3. Zaznacz wszystkie i wybierz akcję „Dezaktywuj”.
  4. Sprawdź, czy strona zaczęła się wyświetlać prawidłowo.

Jeśli biały ekran zniknął – oznacza to, że problem leży w jednej z wtyczek.

Następnie wykonuj poniższe działania:

  • włączaj wtyczki po jednej i za każdym razem sprawdzaj stronę,
  • gdy po włączeniu konkretnej wtyczki biały ekran wróci, masz już zidentyfikowanego winowajcę,
  • pozostaw ją wyłączoną, poszukaj aktualizacji lub zamiennika.

Jeśli nie masz dostępu do panelu (biały ekran wszędzie)

Użyj FTP/SFTP lub menedżera plików hostingu i postępuj według kroków:

  1. Wejdź do katalogu wp-content/.
  2. Znajdź folder plugins.
  3. Zmień jego nazwę na np. plugins_old lub plugins_disabled.
  4. Odśwież stronę – jeśli się wyświetla, problem był w wtyczkach.

Zmiana nazwy folderu plugins spowoduje dezaktywację wszystkich wtyczek.

Dalsze postępowanie po odzyskaniu dostępu: przywróć nazwę folderu plugins do oryginalnej, a w środku zmieniaj nazwy pojedynczych folderów wtyczek, aby zidentyfikować, który plugin powoduje błąd.

Krok 3 – zmień motyw na domyślny

Jeśli wyłączenie wszystkich wtyczek nie pomaga, kolejnym podejrzanym jest motyw (szablon).

Zmiana motywu z poziomu panelu

Jeśli masz dostęp do /wp-admin, wykonaj te kroki:

  1. Wejdź w Wygląd → Motywy.
  2. Aktywuj jeden z domyślnych motywów WordPressa, np. Twenty Twenty-Three.
  3. Sprawdź, czy biały ekran zniknął.

Jeśli po przełączeniu na domyślny motyw strona działa poprawnie, wcześniejszy motyw zawierał błąd.

Zmiana motywu przez FTP

Gdy panel jest niedostępny, możesz wymusić zmianę motywu przez FTP:

  1. Zaloguj się przez FTP/SFTP.
  2. Wejdź do wp-content/themes/.
  3. Zmień nazwę folderu aktualnie aktywnego motywu (np. moj-motyw) na inną, np. moj-motyw_old.
  4. WordPress automatycznie spróbuje przełączyć się na domyślny motyw (jeśli jest dostępny).
  5. Odśwież stronę i sprawdź rezultat.

Krok 4 – zwiększ limit pamięci PHP (WP_MEMORY_LIMIT)

Jeśli w logach widzisz komunikat o przekroczeniu pamięci („Allowed memory size of… exhausted”), zwiększ limit pamięci dla WordPressa i/lub w konfiguracji PHP.

Zwiększenie pamięci w wp-config.php

  1. Otwórz wp-config.php przez FTP/SFTP lub menedżer plików.
  2. Dodaj (lub zmień) linijkę z limitem pamięci, np.:

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

W przypadku bardziej wymagających stron możesz użyć wyższego limitu:

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

  1. Umieść tę linijkę przed komentarzem „/* That’s all, stop editing! */”.

W praktyce spotyka się limity od 64 MB do 256 MB, a dla rozbudowanych stron lub kreatorów typu Elementor nawet 512 MB.

Zmiana parametrów PHP po stronie serwera

Niektóre firmy hostingowe pozwalają zmieniać parametry PHP (np. memory_limit, max_execution_time, post_max_size) z poziomu panelu lub pliku php.ini/.htaccess. W niektórych przypadkach zwiększenie memory_limit nawet do 1 GB oraz podniesienie pozostałych parametrów rozwiązuje problem białego ekranu.

Krok 5 – wyczyść pamięć podręczną (cache)

Gdy biała strona wynika z błędów cache (np. po aktualizacji wtyczki cache lub zmianach konfiguracji), warto wyczyścić pamięć podręczną.

Najczęstsze źródła cache to:

  • wtyczki cache (np. generujące statyczne wersje stron),
  • cache serwerowy (np. opcache, memcached) – często włączany przez hosting,
  • zewnętrzne CDN (np. Cloudflare) – buforujące stronę na swoich serwerach.

Jeśli masz dostęp do /wp-admin, użyj opcji „Wyczyść cache / Clear cache” w używanej wtyczce cache oraz wyczyść cache w panelu hostingu, jeśli jest taka możliwość.

Jeśli nie masz dostępu do panelu, tymczasowo wyłącz wtyczkę cache (jak w kroku o wtyczkach – zmiana nazwy folderu) i w razie potrzeby usuń zawartość folderu wp-content/cache (ostrożnie, tylko jeśli wiesz, co robisz).

Krok 6 – sprawdź plik .htaccess

Uszkodzony lub źle skonfigurowany plik .htaccess może uniemożliwić prawidłowe działanie WordPressa i powodować białe strony.

Tymczasowe wyłączenie .htaccess

  1. Wejdź przez FTP/SFTP do katalogu głównego WordPressa.
  2. Znajdź plik .htaccess.
  3. Zmień jego nazwę na .htaccess_old.
  4. Odśwież stronę i sprawdź, czy biały ekran zniknął.

Jeśli problem ustąpi, wina leżała w konfiguracji .htaccess.

Po przywróceniu działania strony zaloguj się do /wp-admin, przejdź do Ustawienia → Bezpośrednie odnośniki i zapisz ustawienia – WordPress wygeneruje nowy, poprawny plik .htaccess.

Krok 7 – problemy po aktualizacji (automatyczne update’y)

Nieudana automatyczna aktualizacja WordPressa, motywu lub wtyczki może pozostawić część plików w stanie niekompletnym i spowodować biały ekran.

Najczęstsze sytuacje wyglądają tak:

  • przerwanie aktualizacji z powodu limitu czasu lub zasobów serwera,
  • brak zgodności wersji wtyczki z aktualną wersją WordPressa,
  • częściowa podmiana plików motywu lub wtyczki.

Co możesz zrobić w takiej sytuacji:

  • jeśli problem pojawił się bezpośrednio po aktualizacji, spróbuj cofnąć zmiany – przywróć poprzednią wersję wtyczki/motywu (z backupu lub repozytorium),
  • przywróć kopię zapasową całej witryny sprzed aktualizacji,
  • sprawdź w logach, które pliki (motyw, wtyczka, pliki jądra WordPressa) generują błąd.

Skuteczne bywa ponowne wgranie czystej paczki WordPressa (pliki jądra) – bez nadpisywania katalogu wp-content – aby naprawić uszkodzone pliki systemowe.

Krok 8 – skorzystaj z kopii zapasowej (backup)

Jeśli wszystkie powyższe metody zawiodą, najbardziej niezawodnym rozwiązaniem jest przywrócenie witryny z kopii zapasowej.

Przywrócenie backupu plików i bazy danych sprzed wystąpienia problemu najczęściej natychmiast rozwiązuje sytuację; ważne, aby kopia była aktualna i sprawdzona, a proces przywracania przeprowadzony zgodnie z instrukcjami hostingu lub wtyczki backupowej.

Krok 9 – sprawdź logi serwera i skontaktuj się z hostingiem

Jeśli mimo debugowania, wyłączenia wtyczek, zmiany motywu i zwiększenia pamięci problem się utrzymuje, przyczyna może leżeć po stronie serwera.

Warto wykonać następujące kroki w panelu hostingu:

  1. Przejdź do sekcji logów serwera – zwykle oznaczone jako „Logi”, „Error logs”, „Logi PHP”.
  2. Sprawdź wpisy z czasu wystąpienia białego ekranu; zwróć uwagę na komunikaty „Fatal error”, nazwy plików, wtyczek i motywów.
  3. Jeśli logi wskazują na ograniczenia zasobów lub błędy konfiguracji PHP – skontaktuj się z pomocą techniczną hostingu.

Gdy standardowe kroki nie pomagają, szybki kontakt z hostingiem często znacząco przyspiesza diagnozę i usunięcie usterki.

Przykładowe scenariusze problemów (case’y praktyczne)

1. Biały ekran po instalacji lub aktualizacji wtyczki

Częsty scenariusz wygląda następująco:

  • instalujesz nową wtyczkę lub aktualizujesz istniejącą,
  • po odświeżeniu strony widzisz biały ekran,
  • logi pokazują fatal error w pliku konkretnej wtyczki.

Rekomendowane rozwiązanie:

  • wyłącz wszystkie wtyczki (lub konkretną wtyczkę) przez panel albo FTP,
  • usuń problematyczny plugin, zainstaluj poprzednią wersję lub znajdź alternatywę,
  • upewnij się, że wtyczka jest zgodna z wersją WordPressa i PHP oferowaną przez hosting.

2. Biały ekran po edycji pliku motywu

Tak może przebiegać ten przypadek:

  • ręcznie edytujesz functions.php lub inny plik motywu,
  • po zapisaniu pliku strona przestaje działać – pojawia się biały ekran,
  • logi wskazują błąd składni (syntax error) w tym pliku.

Rozwiązanie:

  • przywróć poprzednią wersję pliku (z backupu lub kopii lokalnej),
  • jeśli nie masz kopii, przełącz motyw na domyślny, aby przywrócić działanie strony,
  • w przyszłości wprowadzaj zmiany w motywie potomnym (child theme), a nie bezpośrednio w głównym motywie.

3. Biały ekran w kreatorze typu Elementor (problem z pamięcią)

W wielu przypadkach powodem białego ekranu w Elementorze jest zbyt niski limit pamięci oraz restrykcyjne parametry PHP.

Skuteczne kroki naprawcze:

  • zwiększenie WP_MEMORY_LIMIT w wp-config.php do 512 MB,
  • podniesienie parametrów memory_limit, post_max_size, upload_max_filesize i max_execution_time po stronie serwera,
  • włączenie debugowania i analiza logów, aby potwierdzić, że po zmianach błędy ustąpiły.

Jak zapobiegać białemu ekranowi w WordPressie w przyszłości?

Oto rekomendowane praktyki, które znacząco zmniejszają ryzyko wystąpienia problemu:

  • Regularne kopie zapasowe – automatyczne backupy plików i bazy danych (codzienne/tygodniowe) z możliwością szybkiego przywrócenia;
  • Testowanie zmian na środowisku staging – aktualizacje WordPressa, motywów i wtyczek najpierw sprawdzaj na testowej kopii strony;
  • Rozsądne zarządzanie wtyczkami – nie instaluj zbędnych wtyczek, usuwaj nieużywane dodatki, aktualizuj tylko sprawdzone wtyczki z wiarygodnych źródeł;
  • Motyw potomny (child theme) – modyfikacje kodu wprowadzaj w child theme, aby uniknąć błędów i utraty zmian przy aktualizacji;
  • Monitorowanie logów błędów – regularnie sprawdzaj logi serwera i plik debug.log, aby wyłapać problemy zanim urosną;
  • Odpowiedni hosting i konfiguracja PHP – wybieraj hosting z odpowiednimi limitami pamięci, aktualną wersją PHP oraz dostępem do logów i konfiguracji;
  • Aktualizacje z rozwagą – aktualizuj regularnie, ale z kopią zapasową i najlepiej poza godzinami największego ruchu.