Biała strona WordPressa (WSOD) - jak ją naprawić

Strona pokazuje tylko biały ekran albo komunikat o błędzie krytycznym? Spokojnie - dane prawie na pewno są całe. Oto procedura diagnozy, która znajduje winowajcę w kilkanaście minut.

Co się właściwie stało

Biały ekran (WSOD - white screen of death) albo „Wystąpił krytyczny błąd na tej witrynie" oznacza jedno: PHP przerwał pracę w trakcie budowania strony. Najczęściej po aktualizacji wtyczki lub motywu, zmianie wersji PHP albo wyczerpaniu pamięci. Ważne: treści w bazie danych są nietknięte - naprawiamy tylko to, co stronę składa.

Krok 0: dwie rzeczy na start

  • Sprawdź, czy panel /wp-admin działa - często błąd dotyczy tylko frontu i naprawa zajmie chwilę.
  • Poszukaj w skrzynce maila „WordPress - problem techniczny" - nowsze wersje same wysyłają link do trybu odzyskiwania, który wskazuje winną wtyczkę po nazwie. To najkrótsza droga.

Krok 1: zajrzyj do logów - tam jest odpowiedź

Zamiast zgadywać, przeczytaj komunikat błędu. W panelu hostingu znajdź logi błędów PHP (u nas: DirectAdmin, sekcja logów - pokazujemy gdzie w przewodniku po DirectAdmin). Szukasz linii „PHP Fatal error" z końca pliku - zawiera ścieżkę winowajcy, np. wp-content/plugins/nazwa-wtyczki/.... Alternatywnie włącz debugowanie w wp-config.php:

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

- błędy trafią do pliku wp-content/debug.log.

Krok 2: wyłącz winną wtyczkę (bez panelu)

Skoro panel może nie działać, wtyczki wyłącza się przez menedżer plików lub FTP: w katalogu wp-content/plugins/ zmień nazwę folderu wtyczki, np. na nazwa-wtyczki.off. WordPress natychmiast ją pominie. Jeśli log nie wskazał konkretnej - zmień nazwę całego folderu plugins (wyłączy wszystkie), sprawdź, czy strona wstała, przywróć nazwę i włączaj wtyczki po jednej.

Krok 3: jeśli to motyw

Gdy log wskazuje na wp-content/themes/twoj-motyw, zmień nazwę jego folderu - WordPress przełączy się na motyw domyślny. Strona będzie wyglądać surowo, ale zadziała, a Ty spokojnie naprawisz motyw (najczęściej: cofnięcie nieudanej edycji functions.php albo aktualizacja niezgodna z wersją PHP).

Krok 4: limit pamięci i wersja PHP

  • Błąd „Allowed memory size exhausted" → podnieś limit: w wp-config.php define('WP_MEMORY_LIMIT', '256M'); (i sprawdź limit PHP w panelu hostingu).
  • Błędy typu „Call to undefined function" tuż po zmianie PHP → wróć na poprzednią wersję PHP w panelu i dopiero po aktualizacji wtyczek próbuj ponownie.

Krok 5: uszkodzony .htaccess i niedokończone aktualizacje

  • Zmień nazwę .htaccess na .htaccess.old i w panelu WP zapisz ponownie ustawienia bezpośrednich odnośników - plik odtworzy się czysty.
  • Komunikat „Briefly unavailable for scheduled maintenance" → usuń plik .maintenance z katalogu głównego; to pozostałość po przerwanej aktualizacji.

Gdy nic nie pomaga: kopia zapasowa

Po to robi się kopie: przywrócenie plików i bazy sprzed awarii to kwadrans. Jeśli ich nie masz - to lekcja na przyszłość, którą opisujemy w tekście o kopiach zapasowych (na naszym hostingu robią się automatycznie co noc).

Uwaga: jeżeli biały ekran pojawił się bez żadnej Twojej zmiany, a w plikach widzisz świeże modyfikacje, których nie robiłeś - to może być infekcja, nie awaria. Wtedy przeczytaj jak usunąć wirusa z WordPressa albo od razu oddaj sprawę nam: odwirusowanie WordPressa od 400 zł netto z bezpłatną analizą.

Powiązane poradniki

Wszystkie poradniki z kategorii: WordPress

Powiązane usługi McProdukt

Zobacz również