Biały ekran w WordPressie – 6 przyczyn i co robić po kolei
Biały ekran (nazywany białym ekranem śmierci) oznacza, że PHP przerwał pracę, zanim zdążył wysłać cokolwiek do przeglądarki. Brzmi groźnie, ale treści i zamówienia niemal zawsze są całe – problem leży w kodzie, który je wyświetla. W większości przypadków naprawa zajmuje kilkanaście minut.
Zanim zaczniesz: dwie zasady
Po pierwsze – niczego nie kasuj. Większość nieodwracalnych szkód powstaje przy „sprzątaniu” w panikę, nie przy samej awarii.
Po drugie – zrób kopię, jeśli masz jak. Nawet kopia zepsutej strony jest lepsza niż jej brak, bo pozwala wrócić do punktu wyjścia po nieudanej próbie naprawy.
Sześć najczęstszych przyczyn
- Wtyczka. Najczęstszy winowajca, zwłaszcza tuż po instalacji lub aktualizacji.
- Motyw. Rzadziej, ale zdarza się po aktualizacji albo zmianie w plikach szablonu.
- Wyczerpany limit pamięci. Objawia się przy imporcie, w sklepie z dużą liczbą produktów albo przy ciężkiej wtyczce.
- Błąd w kodzie. Zwykle po ręcznej edycji pliku w panelu – jeden brakujący znak wystarczy.
- Zmiana wersji PHP. Hosting podniósł wersję, a stara wtyczka przestała działać.
- Uszkodzone pliki WordPressa. Najrzadsze, zwykle po przerwanej aktualizacji lub po włamaniu.
Jak to sprawdzić krok po kroku
- Włącz dziennik błędów. W pliku wp-config.php ustaw WP_DEBUG i WP_DEBUG_LOG na true. Błędy trafią do pliku debug.log w katalogu wp-content i zwykle wskażą winowajcę z nazwy.
- Wyłącz wszystkie wtyczki. Jeśli nie masz dostępu do panelu, zmień nazwę katalogu wp-content/plugins na plugins-off. Strona wróciła? Winna jest wtyczka.
- Włączaj wtyczki pojedynczo. Przywróć nazwę katalogu i aktywuj je po kolei, sprawdzając stronę po każdej. Ta, przy której ekran znowu zbieleje, to Twój sprawca.
- Przełącz motyw na domyślny. Jeśli wtyczki są niewinne, zmień nazwę katalogu motywu – WordPress przełączy się na domyślny.
- Podnieś limit pamięci. U większości hostingów to jedno pole w panelu. Jeśli po tym strona wraca, problem był w zasobach, nie w kodzie.
- Sprawdź wersję PHP. Jeśli awaria pojawiła się po zmianie wersji przez hosting, cofnięcie jej to szybki test.
Co, jeśli panel też jest biały
Biały panel administracyjny przy działającej stronie (albo odwrotnie) zawęża poszukiwania. Gdy pusty jest tylko panel, przyczyną jest zwykle wtyczka działająca po stronie administracyjnej. Gdy pusta jest tylko strona – motyw albo wtyczka frontowa.
Jeśli nie masz dostępu do plików, zostaje panel hostingu: menedżer plików albo dostęp FTP. Bez jednego z nich samodzielna naprawa jest praktycznie niemożliwa i wtedy szybciej wychodzi oddanie tego komuś.
Jak zapobiec kolejnemu razowi
- Aktualizuj na kopii roboczej, nie na żywej stronie.
- Trzymaj kopie zapasowe poza serwerem strony.
- Ogranicz liczbę wtyczek – każda to potencjalny sprawca.
- Nie edytuj plików przez wbudowany edytor w panelu; jeden literówka i strona znika.
Częste pytania
Czy stracę treści przy białym ekranie?
Prawie nigdy. Wpisy, strony i zamówienia siedzą w bazie danych, a biały ekran dotyczy warstwy, która je wyświetla.
Czy mogę naprawić to sam?
Tak, jeśli masz dostęp do plików strony i kopię zapasową. Kroki wyżej rozwiązują większość przypadków.
Ile trwa naprawa u specjalisty?
Zwykle od kilkunastu minut do dwóch godzin. Dłużej, gdy biały ekran jest skutkiem czegoś większego – na przykład infekcji.
Dlaczego strona zbielała bez żadnej zmiany z mojej strony?
Najczęściej zadziałała automatyczna aktualizacja wtyczki albo hosting zmienił wersję PHP. Obie rzeczy dzieją się bez Twojego udziału.
Procedura na podstawie dokumentacji WordPressa dotyczącej diagnostyki oraz naszych napraw.