WordPress utknął w trybie konserwacji lub aktualizacja się nie udała – co zrobić

Ilustracja: komunikat trybu konserwacji WordPress i plik .maintenance do usunięcia z katalogu głównego

Na czas aktualizacji WordPress na chwilę wyłącza stronę i pokazuje komunikat o planowanych pracach konserwacyjnych (po angielsku „Briefly unavailable for scheduled maintenance. Check back in a minute.”). Zwykle trwa to kilka sekund. Jeśli jednak aktualizacja zostanie przerwana, komunikat zostaje – czasem na długie godziny.

Dlaczego strona utknęła?

Na początku aktualizacji WordPress tworzy w katalogu głównym strony plik .maintenance, a po jej zakończeniu go usuwa. Gdy aktualizacja się przerwie – zamknięta karta przeglądarki, limit czasu wykonywania skryptu, brak pamięci albo aktualizacja wielu wtyczek naraz – plik zostaje, a strona dalej „trwa w konserwacji”.

Krok 1: usuń plik .maintenance

  • Połącz się z serwerem przez FTP/SFTP lub otwórz menedżer plików w panelu hostingu.
  • Włącz wyświetlanie ukrytych plików – nazwa zaczyna się od kropki, więc wiele programów domyślnie go nie pokazuje.
  • W katalogu głównym WordPressa (tam, gdzie jest wp-config.php) usuń plik .maintenance.

Przez WP-CLI zrobisz to jednym poleceniem:

wp maintenance-mode deactivate

Krok 2: sprawdź, czy aktualizacja się dokończyła

Po usunięciu pliku strona wróci, ale aktualizacja mogła zostać w połowie. Wejdź w Kokpit → Aktualizacje i sprawdź, czy rdzeń i wtyczki mają aktualne wersje. Jeśli nie – zaktualizuj je ponownie, tym razem po jednej.

Zaznaczenie wszystkich wtyczek i kliknięcie „Aktualizuj” to najprostszy sposób na utknięty tryb konserwacji. Aktualizuj po kolei – to tylko kilka minut więcej.

„Another update is currently in progress”

WordPress odmawia aktualizacji, bo uważa, że poprzednia wciąż trwa. Blokada zwykle sama znika po kilkunastu minutach. Jeśli nie – usuń ją ręcznie w phpMyAdmin: w tabeli wp_options znajdź wiersz o nazwie core_updater.lock i go usuń. Lub przez WP-CLI:

wp option delete core_updater.lock

Wtyczka zniknęła lub „Folder docelowy już istnieje”

Przerwana aktualizacja wtyczki potrafi zostawić niekompletny katalog – wtyczka znika z listy albo przy ponownej instalacji pojawia się komunikat, że folder docelowy już istnieje. Wtedy:

  • usuń niekompletny katalog wtyczki z wp-content/plugins (ustawienia wtyczki w bazie danych zostaną),
  • wyczyść katalog wp-content/upgrade z pozostałości,
  • zainstaluj wtyczkę ponownie z oficjalnego źródła.

Nowsze wersje WordPressa potrafią same przywrócić poprzednią wersję wtyczki, gdy aktualizacja się nie powiedzie – ale nie warto na tym polegać zamiast kopii zapasowej.

Strona po aktualizacji działa, ale „coś się rozjechało”

Wygląd się zmienił, przyciski nie działają, edytor nie zapisuje zmian? Najpierw wyczyść cache – wtyczki, serwera i CDN – oraz pamięć przeglądarki. Jeśli to nie pomoże, poszukaj w historii zmian wtyczki informacji o niekompatybilności albo przywróć jej poprzednią wersję z kopii.

Jak aktualizować, żeby nie utknąć:

  • Kopia zapasowa tuż przed aktualizacją.
  • Aktualizacje pojedynczo, przy otwartej karcie, aż do końca.
  • Wystarczający limit pamięci i czasu wykonywania PHP na hostingu.
  • Więcej w poradniku o bezpiecznych aktualizacjach WordPressa.

Najczęstsze pytania

Dlaczego strona pokazuje „Trwają prace konserwacyjne”?

WordPress włącza ten tryb na czas aktualizacji. Jeśli aktualizacja się przerwała, strona może w nim utknąć, bo w głównym katalogu został plik .maintenance.

Jak wyłączyć tryb konserwacji w WordPressie?

Usuń plik o nazwie .maintenance z głównego katalogu strony (przez FTP lub menedżer plików na hostingu). Strona od razu wróci do normalnego działania.

Jak uniknąć utknięcia przy aktualizacji?

Aktualizuj pojedynczo, nie przerywaj procesu, miej stabilne łącze i rób kopię przed większymi aktualizacjami. Przy rozbudowanych stronach testuj zmiany najpierw na kopii testowej.

Potrzebujesz pomocy z tym tematem?

MAQ Enterprise zajmie się tym za Ciebie – od jednorazowego audytu po stałą opiekę nad stroną. Zadzwoń: +48 604 790 398 lub napisz.

Napisz do mnie