Biała strona w WordPress to jeden z bardziej nieprzyjemnych błędów — przeglądarka nic nie wyświetla, panel admina nie odpowiada, a komunikat o błędzie krytycznym pojawia się tylko przez chwilę albo wcale. Poniżej znajdziesz sprawdzone sposoby na odzyskanie dostępu i przywrócenie działania strony.

Co oznacza „biała strona” i critical error w WordPress?

Biała strona (White Screen of Death) i komunikat „There has been a critical error on this website” to dwa objawy tego samego problemu — WordPress nie może dokończyć ładowania strony. Najczęstsza przyczyna to błąd PHP: w motywie, wtyczce lub samym WordPressie doszło do wyjątku, który zatrzymał całe wykonywanie skryptu.

Skutek jest identyczny niezależnie od przyczyny: ani frontend, ani zaplecze administracyjne nie są dostępne przez przeglądarkę.

Najczęstsze przyczyny

  • Aktualizacja wtyczki lub motywu, która wprowadziła błąd w kodzie PHP
  • Przekroczony limit pamięci PHP (memory limit)
  • Niezgodność wersji PHP z wymaganiami wtyczki lub motywu
  • Uszkodzony plik functions.php po ręcznej edycji
  • Konflikt między wtyczkami
  • Nieudana aktualizacja samego WordPressa

Jak odzyskać dostęp krok po kroku

1. Sprawdź link do trybu odzyskiwania

WordPress od wersji 5.2 wysyła na adres e-mail administratora wiadomość z unikalnym linkiem do trybu odzyskiwania (recovery mode). Wejście przez ten link pozwala zalogować się do panelu i wyłączyć problematyczną wtyczkę lub motyw bez dostępu przez FTP. To najprostszy pierwszy krok — sprawdź skrzynkę, włącznie z folderem spam.

2. Wyłącz wtyczki przez FTP lub menedżer plików

Jeśli link odzyskiwania nie dotarł lub nie działa, połącz się z serwerem przez FTP albo menedżer plików w panelu hostingu. Przejdź do katalogu wp-content/plugins i zmień nazwę folderu aktywnej wtyczki, którą ostatnio instalowałeś lub aktualizowałeś — na przykład z nazwa-wtyczki na nazwa-wtyczki-OLD. WordPress uzna ją za nieaktywną i załaduje resztę strony.

Jeśli nie wiesz, która wtyczka jest winna, zmień nazwę całego folderu plugins na plugins-OLD — WordPress wyłączy wszystkie wtyczki jednocześnie. Po odzyskaniu dostępu aktywuj je ponownie pojedynczo, żeby znaleźć źródło problemu.

3. Przywróć domyślny motyw

Jeśli wyłączenie wtyczek nie pomogło, problem może leżeć w motywie. Przez FTP przejdź do wp-content/themes i zmień nazwę folderu aktywnego motywu. WordPress automatycznie przełączy się na motyw domyślny (np. Twenty Twenty-Four), jeśli jest zainstalowany. Po zalogowaniu możesz sprawdzić logi błędów lub przywrócić poprzednią wersję motywu z kopii zapasowej.

4. Zwiększ limit pamięci PHP

Jeśli strona zawiesza się bez wyraźnego błędu po konkretnej operacji, przyczyną może być wyczerpanie przydzielonej pamięci. W pliku wp-config.php dodaj lub zmień linię:

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

Możliwy zakres zależy od konfiguracji serwera — jeśli wartość była już wysoka, problem leży gdzie indziej.

5. Włącz tryb debugowania

Aby zobaczyć dokładną treść błędu, włącz debugowanie PHP w pliku wp-config.php:

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

Log błędów pojawi się w pliku wp-content/debug.log. Znajdziesz tam nazwę pliku i numer linii, w której wystąpił problem — to znacznie skraca diagnozę.

6. Przywróć kopię zapasową

Jeśli żaden z powyższych kroków nie przynosi efektu, a masz aktualną kopię zapasową, przywrócenie jej jest najpewniejszym rozwiązaniem. Dobra polityka backupu zakłada regularne kopie bazy danych i plików — najlepiej automatyczne, poza serwerem głównym.

Kiedy warto zlecić to specjaliście

Diagnoza białej strony bywa prosta, ale nie zawsze. Jeśli błąd pojawia się tylko na części podstron, wraca po chwili albo wiąże się z uszkodzoną bazą danych — samodzielne działanie może pogłębić problem, szczególnie bez aktualnej kopii zapasowej. W takich przypadkach bezpieczniej powierzyć naprawę komuś, kto ma dostęp do logów serwera i doświadczenie z WordPress od strony technicznej.

FAQ - najczęstsze pytania

Czy biała strona w WordPress zawsze oznacza błąd w kodzie?

Nie zawsze — poza błędami PHP przyczyną może być przeciążony serwer, wyczerpany limit pamięci lub problem z bazą danych. Dlatego przed ingerowaniem w pliki warto najpierw sprawdzić, czy strona jest w ogóle osiągalna z innego urządzenia lub sieci.

Czy można naprawić białą stronę bez dostępu do FTP?

Tak, jeśli WordPress wysłał link do trybu odzyskiwania na adres e-mail administratora — wystarczy go kliknąć i zalogować się normalnie do panelu. Jeśli link nie dotarł, konieczny będzie dostęp przez FTP lub menedżer plików w panelu hostingu.

Jak długo trwa diagnoza białej strony przez specjalistę?

Przy dostępie do logów serwera i kopii zapasowej doświadczony administrator zazwyczaj lokalizuje przyczynę w ciągu kilkudziesięciu minut. Czas wydłuża się, gdy logi są wyłączone, brak backupu lub problem dotyczy uszkodzonej bazy danych.

Czy włączenie trybu debug może zaszkodzić stronie?

Sam tryb debugowania nie uszkadza strony, ale ustawienie WP_DEBUG_DISPLAY na true spowoduje, że komunikaty błędów będą widoczne publicznie dla odwiedzających. Dlatego bezpieczniej zapisywać logi do pliku z opcją WP_DEBUG_LOG i wyłączyć ich publiczne wyświetlanie.

Co zrobić, jeśli biała strona wraca po kilku minutach od naprawy?

Powracający błąd sugeruje głębszy problem — np. konflikt uruchamiany przez crona WordPressa, automatyczną aktualizację lub uszkodzony rekord w bazie danych. W takim przypadku samo wyłączanie wtyczek nie wystarczy i warto przeanalizować logi serwera oraz historię zmian.

Podobne wpisy