WordPress utknął w trybie konserwacji po aktualizacji? Oto jak odzyskać dostęp do strony

Rozpoczynasz aktualizację WordPressa, proces startuje bez zarzutu, a po chwili zamiast strony widnieje informacja o trwających pracach konserwacyjnych. Odświeżasz raz, drugi, piąty - komunikat nie ustępuje. Taka sytuacja zdarza się częściej, niż mogłoby się wydawać, i zwykle nie oznacza poważnej usterki.

W typowym scenariuszu WordPress uruchamia tryb konserwacji na czas instalowania aktualizacji, lecz z różnych przyczyn nie wyłącza go po zakończeniu operacji. Zazwyczaj wystarczy wejść do plików serwisu i skasować jeden drobny plik, by strona wróciła do życia.

Poniżej wyjaśniamy, na czym polega błąd maintenance, gdzie szukać pliku .maintenance, jak go bezpiecznie usunąć oraz co zrobić, gdy mimo to strona dalej nie działa. Podpowiadamy również, jak ograniczyć ryzyko powtórki tego scenariusza przy następnych aktualizacjach.

Na czym polega błąd maintenance w WordPressie?

Tryb konserwacji to standardowy element działania WordPressa. Aktywuje się podczas wykonywania niektórych aktualizacji, dzięki czemu odwiedzający nie natrafią na stronę w chwili, gdy część plików pochodzi już z nowej wersji, a część wciąż ze starej.

Można to porównać do tabliczki „trwają prace techniczne” zawieszonej na drzwiach sklepu - w zapleczu trwa wymiana elementów i chwilowo bezpieczniej nie wpuszczać nikogo do środka.

Od strony technicznej mechanizm ten opiera się na pliku .maintenance, umieszczanym w głównym katalogu instalacji. Jest to element samego WordPressa, a jego działanie opisuje oficjalna dokumentacja projektu.

W poprawnym przebiegu proces wygląda następująco:

• WordPress rozpoczyna aktualizację
• uruchamia tryb konserwacji
• pobiera i podmienia potrzebne pliki
• kończy aktualizację
• wyłącza maintenance i strona wraca do normalnego działania

Cały proces trwa zwykle na tyle krótko, że odwiedzający strony nawet go nie zauważą. Kłopoty zaczynają się dopiero, gdy któryś z tych etapów zostanie przerwany.

Skąd bierze się utknięcie w trybie konserwacji?

Sam komunikat maintenance to zwykle objaw, a nie właściwe źródło problemu. WordPress zdążył zasygnalizować rozpoczęcie aktualizacji, ale sam proces urwał się, zanim dobiegł końca.

Przyczyn może być kilka: przekroczenie limitu czasu wykonywania skryptu, przerwanie procesu PHP, brak wolnej przestrzeni dyskowej albo problem z uprawnieniami do plików. Kłopot może też generować sama aktualizowana wtyczka lub motyw.

Szczególną ostrożność warto zachować przy jednoczesnej aktualizacji kilkunastu lub kilkudziesięciu elementów naraz. Im więcej operacji wykonywanych jest w jednym procesie, tym trudniej później wskazać, co dokładnie zawiodło.

Zanim przystąpisz do naprawy, warto wykonać dodatkową kopię aktualnego stanu plików i bazy danych. Nawet jeśli witryna w tej chwili nie działa, taka kopia może się przydać podczas dalszej diagnostyki - więcej informacji na ten temat znajduje się w poradniku dotyczącym backupu WordPressa.

Jak usunąć plik .maintenance i przywrócić działanie strony?

Jeśli komunikat o pracach konserwacyjnych pojawił się bezpośrednio w trakcie aktualizacji, w pierwszej kolejności warto zajrzeć do pliku .maintenance.

Nie ma potrzeby logowania się do kokpitu WordPressa - potrzebny jest bezpośredni dostęp do plików strony, przez FTP, SSH lub menedżer plików dostępny w panelu hostingowym. W przypadku korzystania z cyber_Folks sposób obsługi tego narzędzia opisano w instrukcji dotyczącej menedżera plików.

Dalsze kroki są proste:

1. Przejdź do katalogu, w którym zainstalowany jest WordPress
2. Sprawdź, czy widoczne są katalogi wp-admin, wp-content i wp-includes
3. Odszukaj plik o nazwie .maintenance
4. Usuń go
5. Odśwież stronę w przeglądarce

Istotna jest kropka na początku nazwy pliku. Wiele narzędzi traktuje pliki zaczynające się od kropki jako ukryte, więc jeśli mimo znajdowania się we właściwym katalogu plik .maintenance nie jest widoczny, warto włączyć w ustawieniach menedżera plików lub klienta FTP opcję wyświetlania plików ukrytych.

Ważna uwaga: nie należy przy okazji kasować innych plików zaczynających się od kropki. .htaccess i .maintenance to dwie zupełnie różne rzeczy - pierwszy odpowiada między innymi za reguły przekierowań i konfigurację serwera WWW. Interesuje nas wyłącznie plik o nazwie .maintenance.

Co zrobić, gdy po usunięciu .maintenance strona nadal nie działa?

Tutaj pojawia się istotna kwestia - skasowanie pliku .maintenance wyłącza tryb konserwacji, ale nie cofa samej aktualizacji. Jeśli proces został przerwany w połowie, na serwerze mogła zostać niekompletna wersja wtyczki, motywu lub innych plików.

Może się więc okazać, że komunikat maintenance zniknie, ale w jego miejsce pojawi się błąd krytyczny WordPressa, biały ekran albo kod HTTP 500.

Jeżeli kłopot rozpoczął się podczas aktualizowania konkretnej wtyczki, warto zacząć właśnie od niej. Gdy panel administracyjny jest niedostępny, wystarczy przejść do katalogu wp-content/plugins i zmienić nazwę katalogu problematycznej wtyczki, na przykład:

example-plugin example-plugin-old

Dzięki temu WordPress przestanie widzieć wtyczkę pod dotychczasową ścieżką i automatycznie ją zdezaktywuje. Jeśli po tej operacji strona zacznie działać, mamy mocną wskazówkę co do źródła awarii.

W bardziej skomplikowanych przypadkach warto podejść do diagnostyki metodycznie - pomocny będzie poradnik o wyszukiwaniu konfliktu wtyczek lub motywu po aktualizacji WordPressa.

Jeśli po wyłączeniu maintenance strona pozostaje całkowicie biała lub PHP zgłasza błąd krytyczny, lepiej nie zgadywać, tylko sprawdzić logi. Ścieżka do pliku, nazwa wtyczki czy konkretny komunikat PHP zwykle pozwalają dotrzeć do przyczyny szybciej niż wyłączanie kolejnych elementów po kolei. Ten sposób diagnostyki opisano szerzej w artykule o białym ekranie w WordPressie.

Jak zweryfikować, że aktualizacja przebiegła prawidłowo?

Ponowne otwarcie strony głównej to dobry sygnał, ale na tym etapie nie warto jeszcze kończyć weryfikacji.

Po nieudanej aktualizacji warto sprawdzić kilka kluczowych elementów:

• otwórz stronę główną i kilka podstron
• zaloguj się do /wp-admin
• sprawdź sekcję Kokpit → Aktualizacje
• zobacz, czy aktualizowana wtyczka lub motyw są aktywne
• sprawdź formularz kontaktowy
• jeśli prowadzisz sklep, wykonaj test koszyka i procesu zamówienia
• wyczyść cache strony, jeżeli korzystasz z mechanizmu pamięci podręcznej lub CDN

Ostatni punkt ma szczególne znaczenie w przypadku witryn realizujących konkretne zadania biznesowe. Samo wyświetlanie się strony głównej nie oznacza jeszcze, że działa formularz, wysyłka poczty, system rezerwacji czy płatności w sklepie.

Gdy WordPress w dalszym ciągu wskazuje dostępną aktualizację dla elementu, na którym wcześniej doszło do przerwania procesu, nie warto uruchamiać jej ponownie bez przygotowania. Najpierw należy wykonać kopię zapasową, upewnić się co do ilości wolnego miejsca i dopiero wtedy powtórzyć operację. Sam proces aktualizacji opisano też w osobnej instrukcji aktualizowania WordPressa.

Wyłączanie trybu maintenance przez WP-CLI

Osoby pracujące z WordPressem częściej i mające dostęp do SSH nie muszą szukać pliku ręcznie - z pomocą przychodzi WP-CLI.

Status trybu konserwacji sprawdza się poleceniem:

wp maintenance-mode status

a wyłącza się go za pomocą:

wp maintenance-mode deactivate

Pełny opis dostępnych poleceń znajduje się w dokumentacji WP-CLI dotyczącej trybu maintenance.

Samo WP-CLI oferuje znacznie więcej możliwości - pozwala sprawdzać wersje wtyczek, wykonywać aktualizacje, zarządzać pamięcią podręczną czy operować na bazie danych. Więcej na ten temat można znaleźć w poradniku o tym, czym jest WP-CLI i jak usprawnia pracę z WordPressem.

Jak ograniczyć ryzyko błędu maintenance przy kolejnej aktualizacji?

Nie sposób zagwarantować, że każda aktualizacja WordPressa, motywu czy wtyczki zakończy się bez zarzutu. Można jednak wyraźnie zmniejszyć ryzyko problemów i, co równie istotne, zapewnić sobie prostą drogę powrotu w razie kłopotów.

• wykonaj backup przed większą zmianą - najlepiej zarówno plików, jak i bazy danych
• nie aktualizuj wszystkiego naraz - przy wielu zmianach wykonanych jednocześnie trudniej znaleźć winowajcę
• sprawdź wolne miejsce na hostingu - aktualizacja wymaga przestrzeni między innymi na pobranie i rozpakowanie nowych plików
• nie odkładaj aktualizacji na wiele miesięcy - duży przeskok wersji zwiększa liczbę zmiennych
• po aktualizacji przetestuj stronę - szczególnie formularze, logowanie, koszyk i inne kluczowe funkcje
• ważniejsze aktualizacje wykonuj poza godzinami największego ruchu

Dobrym rozwiązaniem jest również automatyczne wykonywanie kopii zapasowej przed każdą aktualizacją. Osoby korzystające z Installatrona znajdą opis możliwości związanych z backupami i aktualizacjami w poradniku Installatron - kopie zapasowe, aktualizacje i powiadomienia.

Na większych stronach firmowych i w sklepach internetowych warto rozważyć posiadanie środowiska testowego. Aktualizacja sprawdzona wcześniej na kopii witryny wywołuje znacznie mniej stresu niż testowanie jej bezpośrednio na stronie, na której w danym momencie znajdują się klienci.

Podsumowanie

Komunikat maintenance potrafi wyglądać groźnie, zwłaszcza gdy pojawia się zaraz po kliknięciu przycisku aktualizacji i cała zawartość strony znika z oczu. W większości przypadków pierwszy krok naprawy jest jednak prosty - wystarczy otworzyć pliki WordPressa, odnaleźć .maintenance i go usunąć.

Kluczowe znaczenie ma jednak to, co dzieje się później. Warto zweryfikować, czy aktualizacja rzeczywiście dobiegła końca, przetestować najważniejsze funkcje witryny i wstrzymać się z kolejnymi zmianami, dopóki nie ma pewności, że WordPress działa prawidłowo.

Warto również zadbać o zaplecze, zanim dojdzie do kolejnej awarii. Regularne kopie zapasowe, aktualizacje wykonywane w kontrolowany sposób oraz hosting przygotowany do obsługi WordPressa pozwalają zaoszczędzić sporo czasu w chwili, gdy coś pójdzie niezgodnie z planem.

Najczęstsze pytania

Co oznacza komunikat maintenance? Oznacza, że WordPress uruchomił tryb konserwacji, najczęściej na czas aktualizacji systemu, wtyczki lub motywu. Jeżeli aktualizacja zostanie przerwana, strona może pozostać w tym trybie dłużej niż powinna.

Gdzie znajduje się plik .maintenance? W głównym katalogu instalacji WordPressa, czyli tam, gdzie znajdują się między innymi katalogi wp-admin, wp-content i wp-includes.

Czy usunięcie pliku .maintenance jest bezpieczne? Jeżeli proces aktualizacji już się zakończył lub został przerwany, usunięcie pliku pozwala wyłączyć tryb konserwacji. Po tej operacji należy jednak sprawdzić, czy sama aktualizacja zakończyła się poprawnie.

Co zrobić, gdy strona nadal nie działa po usunięciu pliku? Sprawdź logi błędów i element, który był aktualizowany. Przyczyną może być niekompletna aktualizacja, konflikt wtyczki lub motywu albo błąd PHP.

Czy da się wyłączyć tryb konserwacji z poziomu terminala? Tak. Jeśli na serwerze dostępne jest WP-CLI, status sprawdza się poleceniem wp maintenance-mode status, a następnie wyłącza tryb konserwacji poleceniem wp maintenance-mode deactivate.

Jak zabezpieczyć się przed powtórką problemu? Przed większą aktualizacją wykonaj kopię zapasową, aktualizuj elementy etapami, sprawdź wolne miejsce na hostingu i po zmianach przetestuj najważniejsze funkcje strony.