Aktualizacja zakończyła się błędem, strona pokazuje pusty ekran, komunikat o błędzie krytycznym albo blokadę z napisem „aktualnie przeprowadzana jest inna aktualizacja”. To moment, w którym pierwszą reakcją bywa panika, ale w większości przypadków stronę da się przywrócić w kilka minut, jeśli wie się, czego szukać.
Z naszej praktyki w opiece nad WordPressem z aktualizacjami wynika, że problemy po nieudanej aktualizacji najczęściej mają jedną z kilku typowych przyczyn, a każda ma stosunkowo proste rozwiązanie. W tym poradniku pokazujemy konkretne kroki dla najczęstszych scenariuszy oraz co zrobić, gdy żaden z nich nie działa.
Najczęstsze błędy po nieudanej aktualizacji WordPressa
Po nieudanej aktualizacji najczęściej spotkasz jeden z czterech komunikatów:
- „Aktualnie przeprowadzana jest inna aktualizacja”, strona jest zablokowana w trybie konserwacji, mimo że aktualizacja już dawno się zatrzymała.
- „W witrynie wystąpił błąd krytyczny”, domyślny komunikat WordPressa, gdy któraś z wtyczek albo motywów wygenerował błąd PHP.
- Biały ekran śmierci (WSOD), strona ładuje się jako pusta, biała plansza bez żadnego komunikatu.
- Błąd 500 (Internal Server Error), komunikat serwera o problemie po stronie aplikacji.
Każdy z tych błędów wskazuje na nieco inną przyczynę, ale rozwiązania są zwykle podobne i sprowadzają się do trzech narzędzi: dostępu FTP albo do menedżera plików w panelu hostingu, dostępu do bazy danych przez phpMyAdmin (rzadko potrzebne) i, jeśli go masz, świeżego backupu.
Zacznij od backupu, jeśli go masz
Jeżeli masz aktualną kopię zapasową strony sprzed aktualizacji, najprostsza i najpewniejsza droga to przywrócenie strony z backupu. Większość wtyczek backupowych (UpdraftPlus, Backup Migration, BackWPup) ma jednoklikowy przycisk przywracania. Hostingi z funkcją automatycznych snapshotów też pozwalają wrócić do stanu sprzed kilku godzin z panelu administracyjnego hostingu.
Po przywróceniu strony aktualizację można powtórzyć w sposób bardziej kontrolowany: na środowisku testowym, pojedynczo, z testem po każdej zmianie.
Jeżeli nie masz świeżego backupu, przejdź do konkretnych rozwiązań poniżej, w zależności od tego, jaki błąd widzisz.
Naprawa konkretnych błędów
„Aktualnie przeprowadzana jest inna aktualizacja”
To najczęstszy i jednocześnie najprostszy do naprawy błąd. WordPress podczas aktualizacji tworzy w głównym katalogu strony plik o nazwie .maintenance. Jeżeli aktualizacja przerwie się przed zakończeniem (przekroczenie limitu czasu PHP, zerwane połączenie, awaria serwera), plik zostaje, a strona pozostaje w trybie konserwacji.
Rozwiązanie:
- Połącz się ze stroną przez FTP albo menedżer plików w panelu hostingu.
- Wejdź do głównego katalogu instalacji WordPressa, tam gdzie znajduje się
wp-config.php. - Znajdź plik
.maintenancei usuń go. - Odśwież stronę.
Po usunięciu pliku strona zwykle wraca do działania w ciągu kilku sekund.
„Wystąpił błąd krytyczny w witrynie”
Komunikat ten pojawia się, gdy któraś z wtyczek albo motywów wygenerowała błąd PHP, którego rdzeń nie potrafi obsłużyć. WordPress w wersjach 5.2 i nowszych wysyła wtedy na adres e-mail administratora link do trybu odzyskiwania. Sprawdź skrzynkę pocztową (również folder spamu), kliknij link i zaloguj się przez ścieżkę naprawczą.
W trybie odzyskiwania możesz dezaktywować problematyczną wtyczkę albo motyw. Po wyłączeniu sprawcy strona zwykle wraca do działania.
Jeśli mail się nie pojawił, alternatywą jest dezaktywacja wszystkich wtyczek przez FTP: zmień nazwę folderu wp-content/plugins na, dla przykładu, plugins-off. WordPress wyłączy wszystkie wtyczki, panel administracyjny stanie się dostępny, a potem możesz włączać wtyczki po jednej i obserwować, która powoduje błąd.
Biały ekran śmierci i błąd 500
Białe ekrany i błędy 500 to zwykle objawy poważniejszego problemu, ale najczęściej nadal sprowadzają się do konfliktu wtyczki albo motywu. Pierwsza akcja jest taka sama: dezaktywacja wszystkich wtyczek przez FTP (zmiana nazwy folderu plugins). Jeśli to nie pomoże, przełącz motyw na domyślny przez zmianę nazwy folderu aktywnego motywu w wp-content/themes. WordPress sam aktywuje wtedy domyślny motyw.
Czasem przyczyną jest za niski limit pamięci PHP. Dodaj do pliku wp-config.php linię define('WP_MEMORY_LIMIT', '256M'); i sprawdź, czy strona ruszy.
Innym częstym powodem jest niezgodność z wersją PHP na hostingu. Po aktualizacji wtyczki, która zakłada nowszą wersję PHP, niż masz na koncie, możesz dostać błąd krytyczny. W takiej sytuacji zajrzyj do osobnego artykułu o aktualizacji PHP w WordPress, gdzie pokazujemy, jak sprawdzić wersję i jak ją zmienić w panelu hostingu.
Co zrobić, gdy żadne z powyższych nie działa
Jeśli żadne z opisanych rozwiązań nie przywraca strony, sprawdź dziennik błędów hostingu (zwykle w sekcji „Logi” albo „Error logs” w panelu hostingu). Logi PHP wskazują konkretny plik i numer linii, gdzie wystąpił błąd, co bardzo zawęża obszar diagnozy.
Drugi krok to kontakt z supportem hostingu. Większość polskich dostawców pomoże zlokalizować przyczynę problemu, a niektóre nawet wykonają podstawowe akcje naprawcze.
Jeżeli sytuacja Cię przerasta albo strona musi działać szybko, opieka nad WordPressem z aktualizacjami obejmuje również naprawę nieudanych aktualizacji. Działamy zwykle w ciągu kilku godzin od zgłoszenia, z raportem i rekomendacjami, żeby uniknąć powtórki. Konkretne warunki znajdziesz w cenniku planów opieki.
Jak uniknąć powtórki
Trzy proste zasady, które wycinają większość problemów po aktualizacji:
- Świeży backup tuż przed każdą aktualizacją, nie raz w tygodniu, tylko bezpośrednio przed wykonaniem zmiany.
- Aktualizacja wtyczek pojedynczo, nie wszystkich naraz, z krótkim testem po każdej.
- Aktualizacja na środowisku testowym dla większych stron i sklepów WooCommerce, zanim zmiana pójdzie na produkcję.
Pełen praktyczny proces opisujemy w przewodniku o aktualizacji WordPressa, a o tym, dlaczego skutki aktualizacji czasem ujawniają się dopiero po tygodniu, piszemy w analizie co może się zepsuć po aktualizacji.
