Biały ekran w WordPressie: jak zdiagnozować i naprawić krok po kroku

Krótka odpowiedź: biały ekran (WSOD, white screen of death) to widoczny objaw błędu krytycznego PHP. Najczęstsze przyczyny to konflikt wtyczki po aktualizacji, niekompatybilny motyw, wyczerpany limit pamięci PHP albo zbyt nowa lub zbyt stara wersja PHP na hostingu. Diagnozę zaczyna się od przeczytania prawdziwego komunikatu błędu w logach, a nie od zgadywania. Poniżej bezpieczna procedura krok po kroku.

Krok 1: sprawdź skrzynkę - WordPress mógł wysłać koło ratunkowe

Od wersji 5.2 WordPress przy błędzie krytycznym wysyła na adres administratora mail 'Twoja witryna ma problem techniczny' z linkiem do trybu odzyskiwania. Ten mail mówi wprost, który plugin lub motyw wywołał błąd, i pozwala zalogować się do kokpitu z wyłączonym winowajcą. Jeśli go masz, diagnoza właśnie się skończyła: wyłącz wskazaną wtyczkę i poszukaj jej aktualizacji albo zamiennika.

Krok 2: przeczytaj prawdziwy błąd w logach

Biały ekran to zasłona, za którą kryje się konkretny komunikat, na przykład 'Fatal error: Uncaught Error: Call to undefined function' z nazwą pliku i linią. Znajdziesz go w logu błędów PHP w panelu hostingu (error_log) albo po włączeniu debugowania: w pliku wp-config.php ustaw WP_DEBUG i WP_DEBUG_LOG na true, odśwież stronę i zajrzyj do wp-content/debug.log. Ścieżka pliku w błędzie wskazuje winowajcę: wp-content/plugins/nazwa-wtyczki oznacza wtyczkę, wp-content/themes/nazwa-motywu oznacza motyw.

Krok 3: metoda połowienia, gdy logi milczą

• Połącz się z serwerem przez FTP lub menedżer plików hostingu.
• Zmień nazwę katalogu wp-content/plugins na plugins-off. Strona wstała? Winna jest wtyczka.
• Przywróć nazwę katalogu, a potem wyłączaj wtyczki połówkami (zmieniając nazwy ich podkatalogów), aż znajdziesz konkretnego winowajcę.
• Jeśli wtyczki są niewinne, podmień motyw: zmiana nazwy katalogu aktywnego motywu zmusi WordPressa do przełączenia na domyślny.
• Winowajcę zaktualizuj, wymień albo zgłoś autorowi. Nie zostawiaj go wyłączonego bez zrozumienia, co robił: mógł obsługiwać płatności albo wysyłkę.

Krok 4: pamięć i wersja PHP

Komunikat 'Allowed memory size exhausted' oznacza wyczerpany limit pamięci: podnieś go w wp-config.php wpisem define('WP_MEMORY_LIMIT', '256M') albo w panelu hostingu. Z kolei błędy typu 'Call to undefined function' lub 'syntax error' po zmianie hostingu często oznaczają niezgodną wersję PHP: stara wtyczka potrafi nie działać na PHP 8.3+, a nowe wersje wtyczek porzucają wsparcie dla PHP 7.4. Wersję PHP zmienisz w panelu hostingu jednym kliknięciem; rób to najpierw na kopii strony.

Kiedy biały ekran oznacza coś poważniejszego

Jeśli strona padła bez żadnej aktualizacji, sprawdź trzy rzeczy: miejsce na dysku serwera (pełny dysk potrafi uszkodzić bazę danych), komunikat 'Error establishing a database connection' (uszkodzona lub przeciążona baza) oraz obce pliki w katalogach WordPressa (infekcja). W tych scenariuszach improwizacja jest kosztowna, bo każda kolejna operacja może nadpisać dane potrzebne do odzyskania sklepu. To moment na profesjonalną pomoc, najlepiej z logami i backupem w ręku.

Jak sprawić, żeby to było ostatni raz

• Aktualizuj przez staging: najpierw kopia, test, dopiero potem produkcja.
• Automatyczne backupy codzienne, przechowywane poza serwerem strony.
• Monitoring dostępności, który powiadomi Cię o awarii, zanim zrobią to klienci.
• Przegląd wtyczek raz na kwartał: każda nieużywana to przyszłe ryzyko.

Potrzebujesz pomocy z tym tematem?

Wdrażamy to, o czym piszemy. Porozmawiaj z nami o swoim projekcie - bezpłatna konsultacja bez zobowiązań.