"Wystąpił krytyczny błąd na tej witrynie" po aktualizacji - przyczyny i naprawa

Komunikat "Wystąpił krytyczny błąd na tej witrynie. Sprawdź skrzynkę odbiorczą administratora" to sposób, w jaki WordPress od wersji 5.2 mówi: kod PHP się wysypał i zatrzymałem ładowanie. W dziewięciu przypadkach na dziesięć dzieje się to tuż po aktualizacji. Poniżej wyjaśniamy, dlaczego, i pokazujemy, jak wrócić do działającej strony.

Dlaczego aktualizacja psuje stronę

• Wtyczka niezgodna z wersją PHP. Hosting podniósł PHP do 8.x, a stara wtyczka używa funkcji usuniętych z języka. Objaw pojawia się nie po aktualizacji wtyczki, ale po cichej zmianie na serwerze.
• Dwie wtyczki robią to samo.Po aktualizacji jedna z nich deklaruje funkcję o nazwie, którą zajmuje już druga. PHP zgłasza "Cannot redeclare".
• Motyw nadpisuje pliki wtyczki. Typowe w WooCommerce: motyw ma stare szablony sklepu, WooCommerce zmienił strukturę, całość się rozjeżdża.
• Aktualizacja przerwana w połowie. Timeout serwera podczas rozpakowywania zostawia niekompletny folder wtyczki.

Krok 1: odczytaj, co WordPress próbuje powiedzieć

Mail do administratora zawiera nazwę pliku i wtyczki, która spowodowała błąd, oraz link do trybu odzyskiwania. Jeśli mail nie dotarł, włącz logowanie błędów w wp-config.php (WP_DEBUG_LOG) i zajrzyj do wp-content/debug.log. Szukaj linii zaczynającej się od "PHP Fatal error". Ścieżka w tej linii wskazuje winowajcę.

Krok 2: cofnij zmianę, nie całą stronę

Przywracanie kopii sprzed tygodnia to ostateczność, bo tracisz nowe treści i zamówienia. Zamiast tego wyłącz konkretną wtyczkę przez FTP (zmiana nazwy jej folderu w wp-content/plugins) i zainstaluj poprzednią wersję. Starsze wersje wtyczek z oficjalnego repozytorium są dostępne w zakładce "Zaawansowany widok" na stronie każdej wtyczki na wordpress.org.

Krok 3: napraw przyczynę

Cofnięcie wersji kupuje czas, ale nie rozwiązuje problemu. Sprawdź, czy wtyczka ma aktualizację zgodną z Twoją wersją PHP, czy jest w ogóle rozwijana (data ostatniej aktualizacji w repozytorium), a jeśli jest porzucona, poszukaj zamiennika. Właśnie na tym etapie większość osób zostawia stronę "na starej wersji" i za pół roku ma tę samą awarię.

Jak aktualizować, żeby to się nie powtarzało

Kopia przed każdą aktualizacją, aktualizacje na środowisku testowym lub przynajmniej po jednej wtyczce naraz, sprawdzanie zgodności z PHP i listy zmian. Rozpisaliśmy to w tekście jak bezpiecznie aktualizować WordPress.

Jeśli wolisz, żeby zrobił to ktoś, kto robi to codziennie: w ramach naprawy strony WordPress usuwamy błąd, aktualizujemy wszystko w bezpiecznej kolejności i zostawiamy raport. Cena jest znana z góry, a diagnoza bezpłatna.