Błąd krytyczny w WordPressie: co to znaczy i jak go naprawić

Błąd krytyczny w WordPressie oznacza, że wtyczka, motyw albo wersja PHP przerwały działanie strony. Naprawia się go, wyłączając winowajcę przez panel, FTP albo menedżer plików na hostingu.

Ten wpis prowadzi od komunikatu do przyczyny. Kroki opieram na dokumentacji WordPressa, a przyczyny to typowe przypadki, nie historie konkretnych klientów.

Co znaczy komunikat „na tej stronie wystąpił błąd krytyczny”?

Komunikat „Na tej stronie wystąpił błąd krytyczny" znaczy, że kod strony natrafił na błąd, którego WordPress nie mógł obsłużyć. Zamiast białej strony odwiedzający widzą ten komunikat.

Ten ekran jest zabezpieczeniem, nie przyczyną. Przyczyna siedzi w kodzie wtyczki, motywu lub w ustawieniach serwera. WordPress od wersji 5.2 wysyła też e-mail do administratora z informacją o błędzie.

Skąd się bierze błąd krytyczny w WordPressie?

Błąd krytyczny najczęściej wynika z konfliktu wtyczki albo niezgodnego motywu. Dokumentacja WordPressa wymienia pięć przyczyn.

Przyczyna	Jak ją rozpoznać	Pierwszy krok
Konflikt wtyczki	błąd pojawił się po aktualizacji lub instalacji wtyczki	wyłącz wtyczki przez FTP
Niezgodny motyw	błąd po zmianie lub aktualizacji motywu	przełącz na motyw domyślny
Nieobsługiwana wersja PHP	błąd po zmianie PHP na hostingu	sprawdź wersję PHP w panelu hostingu
Limit pamięci	błąd przy ciężkich operacjach	sprawdź limit pamięci PHP
Uszkodzone pliki	błąd po przerwanym przesyłaniu lub aktualizacji	odtwórz pliki z kopii

Jak znaleźć przyczynę błędu krytycznego?

Najszybciej znajdziesz przyczynę w e-mailu od WordPressa albo w pliku debug.log. E-mail trafia na adres administratora strony i opisuje, który plik spowodował błąd.

Jeśli e-maila nie ma, włącz zapis błędów do pliku. Dodaj te linie do pliku wp-config.php, przed napisem „That's all, stop editing!":

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Błędy zapiszą się w pliku wp-content/debug.log, a odwiedzający nie zobaczą ich na stronie. Otwórz plik i szukaj ostatnich wpisów z nazwą wtyczki lub motywu w ścieżce.

Dokumentacja WordPressa radzi używać trybu debugowania na kopii testowej, nie na stronie na żywo. Jeśli diagnozujesz stronę produkcyjną, włącz go tylko na czas diagnozy i po jej zakończeniu usuń te linie.

Jak wyłączyć wtyczkę lub motyw przez FTP?

Wyłączenie wtyczki przez FTP polega na zmianie nazwy jej folderu. Dokumentacja opisuje wariant dla wszystkich wtyczek naraz.

1. Połącz się z hostingiem przez FTP albo otwórz menedżer plików w jego panelu.
2. Wejdź do katalogu wp-content.
3. Zmień nazwę folderu plugins na plugins_old. WordPress wyłączy wszystkie wtyczki.
4. Odśwież stronę. Jeśli działa, przyczyną była wtyczka.
5. Wróć do nazwy plugins, a potem zmieniaj nazwy folderów pojedynczych wtyczek w środku, aż znajdziesz tę, która psuje stronę.

Przy podejrzeniu motywu zmień nazwę folderu aktywnego motywu w wp-content/themes. WordPress przełączy się wtedy na motyw domyślny, o ile jest zainstalowany.

Jak odzyskać dostęp do panelu po błędzie krytycznym?

Dostęp do panelu odzyskasz przez tryb odzyskiwania, który WordPress oferuje od wersji 5.2. Wiadomość e-mail od WordPressa zawiera link do tego trybu i trafia na adres administratora strony.

Po kliknięciu linku zalogujesz się do panelu, a wtyczki i motywy powodujące błąd zostaną wstrzymane tylko dla twojej przeglądarki. Pozostali odwiedzający nadal widzą błąd. Wstrzymane rozszerzenia możesz wtedy wyłączyć albo zaktualizować.

Jeśli e-mail nie dotarł, sprawdź folder ze spamem i adres administratora w ustawieniach. Gdy go nie masz, zostaje FTP z poprzedniej sekcji.

Błąd połączenia z bazą danych to inny błąd

Komunikat o błędzie połączenia z bazą danych to osobny problem, nie błąd krytyczny: strona nie może pobrać treści, bo baza nie odpowiada albo dane dostępowe są nieprawidłowe. Opisuję go na stronie naprawa WordPress.

Co zrobić, jeśli nic nie pomaga?

Jeśli wyłączenie wtyczek i motywu nie pomogło, a log nie wskazuje przyczyny, przestań próbować na ślepo. Kolejne zmiany bez kopii zapasowej mogą pogorszyć sytuację.

Napisz albo zadzwoń: odpowiadam w ciągu 24 godzin, a naprawy rozliczam godzinowo od 1 godziny, z kwotą podaną po diagnozie. Cały proces opisuję na stronie naprawa WordPress.

Jak uniknąć błędu krytycznego w przyszłości?

Błędom krytycznym zapobiegają trzy nawyki: kopia zapasowa przed zmianą, test zmiany na środowisku testowym i aktualizowanie wtyczek po jednej.

• Wykonuj kopię zapasową przed każdą aktualizacją.
• Testuj duże aktualizacje na kopii strony.
• Aktualizuj wtyczki po jednej i sprawdzaj stronę po każdej.
• Usuwaj wtyczki, których nie używasz.

Szczegóły aktualizacji opisuję we wpisie o aktualizacji WordPressa krok po kroku. Jeśli wolisz, żeby robił to ktoś na stałe, jest to zakres opieki nad stroną WordPress.

Najczęstsze pytania

Dlaczego WordPress nie działa po aktualizacji?

Najczęściej przez konflikt wtyczki lub motywu z nową wersją albo przez zbyt starą wersję PHP. Tabelę objawów i przyczyn masz we wpisie o aktualizacji WordPressa.

Czy błąd krytyczny usunie dane?

Zwykle nie. Treści i ustawienia leżą w bazie danych, a błąd dotyczy kodu. Gwarancji nie ma, dlatego przed każdą zmianą rób kopię zapasową.

Czy można naprawić błąd bez dostępu do panelu?

Tak. Wtyczki i motyw wyłączysz przez FTP lub menedżer plików na hostingu, a tryb odzyskiwania daje link w e-mailu od WordPressa.