CodeFix.IT
WordPress • zdalnie • cała Polska
Biały ekran w WordPressie — jak znaleźć przyczynę i przywrócić stronę
Biały ekran (ang. White Screen of Death) to strona bez treści i bez żadnego komunikatu. Nowsze wersje WordPressa przy większości błędów PHP pokazują komunikat o błędzie krytycznym, więc całkiem pusta strona zwykle oznacza jedno z dwóch: błąd wystąpił, zanim WordPress zdążył go przechwycić, albo strona się ładuje, ale nie wyświetla przez cache lub skrypty. Pierwsze minuty warto poświęcić na ustalenie, który to przypadek.
Spis treści
1. Ustal, gdzie i komu pokazuje się biały ekran
Od odpowiedzi na te pytania zależy cała dalsza diagnostyka. Najważniejszy test to podgląd źródła strony (Ctrl+U w przeglądarce): pusty kod oznacza problem po stronie serwera, a pełny kod HTML przy białym ekranie — problem z wyświetlaniem.
- czy biały ekran widać też w oknie prywatnym i na telefonie w innej sieci
- czy dotyczy całej strony, tylko panelu /wp-admin czy jednej podstrony
- czy źródło strony (Ctrl+U) jest puste, czy zawiera kod HTML
- co zmieniało się tuż przed awarią: aktualizacja, nowa wtyczka, wersja PHP, przeprowadzka hostingu
2. Pusty kod strony: odczytaj log błędów PHP
Najszybciej przyczynę pokaże log. W panelu hostingu zwykle jest log błędów PHP; możesz też w pliku wp-config.php ustawić WP_DEBUG i WP_DEBUG_LOG na true, a WP_DEBUG_DISPLAY na false — wtedy błędy trafią do pliku wp-content/debug.log, a nie na ekran odwiedzających. Po diagnozie wyłącz te ustawienia.
Log zwykle wskazuje konkretną wtyczkę lub motyw. Bez dostępu do panelu wyłączysz wtyczkę, zmieniając nazwę jej folderu w wp-content/plugins przez menedżer plików hostingu lub FTP. Częste przyczyny to też za niski limit pamięci PHP i niezgodność wtyczki z nową wersją PHP.
3. Kod jest, ale strona biała: cache i skrypty
Jeśli źródło strony zawiera treść, a ekran jest pusty, winne bywają wtyczki optymalizujące (łączenie i opóźnianie skryptów, minifikacja CSS), błąd JavaScript w kreatorze stron albo pusta wersja strony zapisana w cache. Otwórz konsolę przeglądarki (F12) i sprawdź, czy są w niej czerwone błędy.
Wyczyść cache we wtyczce, w panelu hostingu i w CDN (np. Cloudflare), a potem na próbę wyłącz optymalizację skryptów i stylów. Jeśli strona wraca, włączaj opcje pojedynczo, aż znajdziesz tę, która ją psuje.
4. Biały ekran tylko w panelu lub na jednej podstronie
Pusty panel /wp-admin przy działającej stronie najczęściej oznacza wtyczkę, która ładuje się tylko w panelu, albo brak pamięci przy cięższych ekranach. Biały ekran na jednej podstronie zwykle wskazuje na szablon, shortcode lub blok używany tylko tam. W obu przypadkach log błędów z kroku 2 zwykle od razu wskazuje winowajcę.
5. Po naprawie: zamknij przyczynę
Samo wyłączenie wtyczki przywraca stronę, ale zostawia lukę w funkcjach, a czasem i w bezpieczeństwie. Zaktualizuj ją lub zastąp, sprawdź zgodność z wersją PHP i usuń tymczasowe ustawienia debugowania.
Żeby awaria się nie powtórzyła: aktualizuj na kopii testowej, pojedynczo i z aktualną kopią zapasową poza serwerem.
Najczęstsze pytania
Czy przez biały ekran stracę treści strony?
Zwykle nie. Wpisy, strony i zamówienia są w bazie danych, a biały ekran to problem z ich wyświetleniem. Nie przywracaj backupu w ciemno — w sklepie stracisz zamówienia złożone po wykonaniu kopii.
Czym biały ekran różni się od komunikatu o błędzie krytycznym?
Przy błędzie krytycznym WordPress przechwycił błąd PHP i pokazał komunikat, często z linkiem do trybu odzyskiwania. Całkiem pusta strona oznacza, że błąd wystąpił wcześniej albo problem leży poza PHP, np. w cache lub skryptach.
Czy da się to naprawić bez dostępu do panelu WordPress?
Tak. Log błędów, plik wp-config.php i foldery wtyczek są dostępne przez panel hostingu lub FTP. Panel WordPress często i tak nie działa, dopóki przyczyna nie zostanie usunięta.
Naprawa WordPress — zobacz zakres usługi
Komunikat „W witrynie wystąpił błąd krytyczny” — jak odzyskać WordPress
Jak bezpiecznie aktualizować WordPress, żeby awaria się nie powtórzyła
Błąd 500 w WordPress — jak znaleźć przyczynę bez zgadywania