Błąd krytyczny WordPress – co oznacza i jak naprawić stronę?

Komunikat „Na tej stronie wystąpił krytyczny błąd” oznacza, że WordPress nie był w stanie poprawnie wykonać kodu potrzebnego do wyświetlenia strony. Sam komunikat nie mówi jeszcze, co dokładnie się zepsuło. Przyczyną może być jedna wtyczka, motyw, niezgodna wersja PHP, brak pamięci, uszkodzony plik albo własna modyfikacja kodu.

Szybka odpowiedź

Jeżeli błąd pojawił się bezpośrednio po aktualizacji lub instalacji konkretnego rozszerzenia, nie zaczynaj od losowych zmian w bazie i plikach. Najpierw zabezpiecz aktualny stan, sprawdź wiadomość wysłaną na adres administratora WordPressa i logi PHP. Następnie wyłącz element, który prawdopodobnie wywołał awarię.

1. Sprawdź, co wydarzyło się tuż przed awarią

Najcenniejszą informacją jest czas. Czy minutę wcześniej była aktualizowana wtyczka? Czy zmieniono wersję PHP? Czy ktoś wkleił kod do functions.php? Czy serwer był migrowany? Jeśli możesz wskazać konkretną zmianę, zacznij od jej odwrócenia.

2. Sprawdź tryb odzyskiwania WordPress

WordPress potrafi wysłać administratorowi e-mail z informacją o problemie technicznym i linkiem do trybu odzyskiwania. Po wejściu tym linkiem można często zalogować się do panelu nawet wtedy, gdy normalna strona nie działa, a WordPress wskaże problematyczne rozszerzenie lub motyw.

Jeżeli wiadomość nie dotarła, nie zakładaj automatycznie, że WordPress jej nie wygenerował. Strona może mieć równocześnie problem z wysyłką poczty.

3. Zajrzyj do logów zamiast zgadywać

Najlepsza naprawa zaczyna się od konkretnego błędu. W kontrolowanym środowisku można włączyć zapisywanie komunikatów do wp-content/debug.log. Na produkcji nie należy natomiast wyświetlać szczegółowych błędów PHP publicznie użytkownikom.

W logu szukaj przede wszystkim Fatal error, Uncaught, nazwy konkretnej wtyczki, motywu albo pliku. Ścieżka wskazana przy błędzie jest często dużo bardziej użyteczna niż sam komunikat w przeglądarce.

4. Jak wyłączyć wtyczkę, kiedy nie działa panel?

Jeżeli log wskazuje na wtyczkę, a panel /wp-admin jest niedostępny, można przez SFTP lub menedżer plików tymczasowo zmienić nazwę jej katalogu w wp-content/plugins. WordPress przestanie ją ładować.

Jeżeli nie wiadomo, która wtyczka odpowiada za awarię, tymczasowe wyłączenie wszystkich rozszerzeń może pomóc potwierdzić konflikt. Potem trzeba je uruchamiać pojedynczo i obserwować rezultat.

5. Sprawdź motyw i własny kod

Błąd krytyczny może pochodzić również z motywu lub kodu dodanego przez wykonawcę. Szczególnie podejrzane są zmiany w functions.php, własne fragmenty PHP oraz stare motywy niedostosowane do aktualnego środowiska.

Nie usuwaj aktywnego motywu bez kopii. Bezpieczniejsze jest sprawdzenie błędu na stagingu albo czasowe przełączenie na znany, zgodny motyw testowy.

6. Wersja PHP i limit pamięci

Po zmianie PHP starsza wtyczka może zacząć zgłaszać błędy, mimo że wcześniej działała. Błędy związane z brakiem pamięci mają charakterystyczne komunikaty o Allowed memory size. Zwiększenie limitu może usunąć objaw, ale jeśli strona nagle zaczęła zużywać dużo więcej pamięci, trzeba także znaleźć przyczynę.

7. Nie aktualizuj wszystkiego naraz podczas awarii

Częsty błąd to próba „naprawy” przez kliknięcie aktualizacji WordPressa, wszystkich wtyczek i motywu jednocześnie. Wtedy zmienia się kilkanaście elementów i później trudno ustalić, co pomogło lub co wywołało kolejny problem.

Podczas awarii zmieniaj jedną rzecz na raz i zapisuj wynik.

8. Kiedy przywracać backup?

Backup jest właściwym rozwiązaniem, gdy trzeba szybko przywrócić działanie serwisu, a przyczyna wymaga dłuższej analizy. Na sklepie lub portalu przywrócenie starej bazy może jednak usunąć nowe zamówienia, formularze czy konta. Dlatego zakres odtwarzania trzeba dobrać do rodzaju serwisu.

Bezpieczna kolejność diagnostyki

Przy problemie błąd krytyczny WordPress najłatwiej stracić czas przez zmienianie kilku rzeczy naraz. Zanim cokolwiek naprawisz, zapisz objaw, godzinę wystąpienia i ostatnie zmiany. Następnie sprawdź logi oraz stan usług, których dotyczy błąd.

Dobra kolejność wygląda tak:

1. potwierdź objaw na konkretnym URL-u lub zamówieniu,
2. sprawdź logi i komunikaty systemowe,
3. ustal ostatnią zmianę,
4. wykonaj kopię przed ingerencją,
5. zmień jeden element,
6. ponownie wykonaj ten sam test,
7. po naprawie sprawdź pozostałe funkcje strony.

Czego nie robić?

Nie czyść bazy, nie resetuj haseł i nie aktualizuj wszystkiego „na wszelki wypadek”, jeżeli nie ma ku temu przesłanek. Takie działania niszczą ślady i zwiększają liczbę niewiadomych. Jeżeli serwis generuje sprzedaż, szybki rollback często jest lepszy niż długa naprawa prowadzona bezpośrednio na produkcji.

Powiązane poradniki HeatLogic

• Kopie zapasowe strony – jak często robić backup?
• WordPress przestał działać po aktualizacji – co robić?
• Błąd połączenia z bazą danych WordPress

Potrzebujesz pomocy?

Jeśli WordPress jest niedostępny i nie chcesz ryzykować kolejnych zmian na żywej stronie, HeatLogic może przeprowadzić diagnostykę, przywrócić działanie i sprawdzić przyczynę awarii.