Błąd maintenance w WordPress. Jak przywrócić stronę po aktualizacji?

Klikasz „Aktualizuj”, WordPress zaczyna pracę, przez chwilę wszystko wygląda normalnie i… zamiast strony widzisz komunikat o trwających pracach technicznych. Mija minuta, druga, piąta, a strona nadal nie wraca. Brzmi znajomo?

Najczęściej nie oznacza to poważnej awarii. WordPress po prostu rozpoczął aktualizację, włączył tryb konserwacji, ale z jakiegoś powodu nie zdążył go prawidłowo wyłączyć. W wielu przypadkach do przywrócenia strony wystarczy dostęp do plików i usunięcie jednego niewielkiego pliku.

W tym artykule pokażę Ci, czym właściwie jest błąd maintenance, gdzie znajduje się plik .maintenance, jak bezpiecznie go usunąć i co sprawdzić, jeśli po jego skasowaniu strona nadal nie działa. Przy okazji zobaczymy też, jak zmniejszyć ryzyko podobnych problemów przy kolejnych aktualizacjach.

Co oznacza błąd maintenance w WordPress?

Tryb maintenance, czyli tryb konserwacji, jest normalnym mechanizmem WordPressa. Włącza się na czas wykonywania niektórych aktualizacji, aby odwiedzający nie zobaczyli strony w momencie, w którym część plików pochodzi już z nowej wersji, a część jeszcze ze starej.

Można porównać go do kartki „trwają prace techniczne” zawieszonej na drzwiach sklepu. Na zapleczu trwa wymiana kilku elementów i na krótką chwilę bezpieczniej nie wpuszczać klientów do środka.

Technicznie WordPress realizuje to za pomocą pliku .maintenance umieszczanego w głównym katalogu instalacji. Mechanizm ten jest częścią samego WordPressa, a jego działanie możesz podejrzeć również w oficjalnej dokumentacji WordPressa.

W prawidłowym scenariuszu wygląda to mniej więcej tak:

• 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ła operacja często trwa na tyle krótko, że osoba odwiedzająca stronę nawet jej nie zauważy. Problem zaczyna się dopiero wtedy, gdy któryś z etapów nie zostanie prawidłowo zakończony.

Dlaczego WordPress zostaje w trybie konserwacji?

Sam komunikat maintenance zazwyczaj jest skutkiem problemu, a nie jego właściwą przyczyną. WordPress zdążył poinformować stronę, że zaczyna aktualizację, ale proces został przerwany przed jej zakończeniem.

Powodów może być kilka. Aktualizacja może przekroczyć dostępny czas wykonywania skryptu, proces PHP może zostać przerwany, może zabraknąć wolnego miejsca albo wystąpić problem z prawami dostępu do plików. Źródłem kłopotów może być również aktualizowana wtyczka lub motyw.

Szczególnie ostrożnie podchodziłbym do aktualizowania za jednym razem kilkunastu czy kilkudziesięciu elementów. Im więcej operacji WordPress musi wykonać podczas jednego procesu, tym trudniej później ustalić, który element był przyczyną problemu.

Podpowiadamy: zanim zaczniesz naprawę, dobrze jest wykonać dodatkową kopię aktualnego stanu plików i bazy. Nawet jeśli strona w tej chwili nie działa prawidłowo, taka kopia może przydać się później podczas diagnostyki. Więcej na ten temat znajdziesz w poradniku jak wykonać backup WordPressa.

Jak usunąć plik .maintenance i przywrócić stronę?

Jeżeli problem pojawił się bezpośrednio podczas aktualizacji i na stronie widzisz charakterystyczny komunikat o pracach konserwacyjnych, w pierwszej kolejności sprawdź plik .maintenance.

Nie musisz w tym celu logować się do kokpitu WordPressa. Potrzebujesz dostępu bezpośrednio do plików strony. Możesz wykorzystać FTP, SSH albo menedżer plików dostępny w panelu hostingu. Jeśli korzystasz z cyber_Folks, sposób pracy z tym narzędziem opisaliśmy w instrukcji dotyczącej obsługi menedżera plików.

Następnie wykonaj kilka prostych kroków:

1. Przejdź do katalogu, w którym zainstalowany jest WordPress.
2. Upewnij się, że widzisz tam katalogi wp-admin, wp-content i wp-includes.
3. Poszukaj pliku o nazwie .maintenance.
4. Usuń go.
5. Odśwież stronę w przeglądarce.

Ważna jest tutaj kropka znajdująca się na początku nazwy. Pliki rozpoczynające się od kropki są w wielu narzędziach traktowane jako ukryte. Jeśli więc jesteś w prawidłowym katalogu, a .maintenance nigdzie nie widać, sprawdź ustawienia menedżera plików lub klienta FTP i włącz wyświetlanie plików ukrytych.

Warto wiedzieć: nie usuwaj przy okazji innych plików zaczynających się od kropki. .htaccess i .maintenance to dwie zupełnie różne rzeczy. Pierwszy z nich może odpowiadać między innymi za reguły przekierowań i konfigurację serwera WWW. Nas interesuje wyłącznie plik o nazwie .maintenance.

Usunąłeś .maintenance, ale strona nadal nie działa?

I tutaj dochodzimy do ważnej rzeczy. Usunięcie pliku .maintenance wyłącza tryb konserwacji, ale nie cofa aktualizacji. Jeżeli proces został przerwany w połowie, na serwerze mogła pozostać niekompletna wersja wtyczki, motywu albo innych plików.

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

Jeśli problem rozpoczął się podczas aktualizacji konkretnej wtyczki, zacząłbym właśnie od niej. Gdy nie możesz dostać się do panelu administratora, przejdź do katalogu wp-content/plugins i zmień nazwę katalogu problematycznej wtyczki, na przykład:

example-plugin example-plugin-old

WordPress przestanie widzieć wtyczkę pod dotychczasową ścieżką i tym samym ją dezaktywuje. Jeżeli strona zacznie wtedy działać, otrzymujesz bardzo mocny trop dotyczący źródła awarii.

Przy bardziej złożonych problemach warto przejść przez diagnostykę metodycznie. Pomocny będzie poradnik pokazujący, jak znaleźć konflikt wtyczek lub motywu po aktualizacji WordPressa.

Jeśli po wyłączeniu maintenance strona jest całkowicie biała albo PHP zwraca błąd krytyczny, nie zgaduj. Zajrzyj do logów. Ścieżka do pliku, nazwa wtyczki lub konkretny komunikat PHP często pozwalają znaleźć przyczynę znacznie szybciej niż wyłączanie wszystkiego po kolei. Taką diagnostykę opisaliśmy szerzej w artykule o białym ekranie w WordPressie.

Jak sprawdzić, czy aktualizacja zakończyła się poprawnie?

Strona główna ponownie się otwiera? To bardzo dobry znak, ale jeszcze nie kończyłbym pracy.

Po nieudanej aktualizacji sprawdź kilka najważniejszych miejsc:

• 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.

Szczególnie ważny jest ostatni etap w przypadku stron wykonujących konkretne zadanie biznesowe. Sam fakt, że wyświetla się strona główna, nie oznacza jeszcze, że działa formularz, wysyłka poczty, rezerwacja czy płatność w sklepie.

Jeżeli WordPress nadal pokazuje dostępną aktualizację elementu, przy którym proces wcześniej się zatrzymał, nie uruchamiałbym jej ponownie w ciemno. Najpierw wykonaj kopię, upewnij się, że masz wystarczającą ilość wolnej przestrzeni i dopiero wtedy ponów operację. Sam proces opisujemy także w instrukcji aktualizowania WordPressa.

Jak wyłączyć maintenance przez WP-CLI?

Jeżeli pracujesz z WordPressem trochę częściej i masz dostęp do SSH, nie musisz szukać pliku ręcznie. Do dyspozycji masz WP-CLI.

Status trybu konserwacji sprawdzisz poleceniem:

wp maintenance-mode status

Aby go wyłączyć, wykonaj:

wp maintenance-mode deactivate

Dokładny opis dostępnych poleceń znajdziesz w dokumentacji WP-CLI dotyczącej maintenance mode.

Samo WP-CLI potrafi znacznie więcej. Możesz z jego pomocą sprawdzać wersje wtyczek, wykonywać aktualizacje, zarządzać cache czy wykonywać operacje na bazie danych. Jeśli chcesz poznać je bliżej, zajrzyj do poradnika WP-CLI – co to jest i jak usprawnia pracę z WordPress.

Jak uniknąć błędu maintenance przy kolejnej aktualizacji?

Nie da się zagwarantować, że każda aktualizacja WordPressa, motywu czy wtyczki zawsze zakończy się sukcesem. Można jednak mocno ograniczyć ryzyko i, co równie ważne, przygotować sobie prostą drogę powrotu.

Ja trzymałbym się kilku zasad:

• wykonaj backup przed większą zmianą – najlepiej zarówno plików, jak i bazy danych;
• nie aktualizuj wszystkiego naraz – przy kilku zmianach wykonanych jednocześnie trudniej później znaleźć winowajcę;
• sprawdź wolne miejsce na hostingu – aktualizacja wymaga miejsca między innymi na pobranie i rozpakowanie nowych plików;
• nie odkładaj aktualizacji przez 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 także automatyczne wykonywanie kopii przed aktualizacją. Jeśli korzystasz z Installatrona, możliwości związane z backupami i aktualizacjami opisaliśmy w poradniku Installatron – kopie zapasowe, aktualizacje i powiadomienia.

Dobra praktyka: na większej stronie firmowej lub sklepie internetowym warto mieć środowisko testowe. Aktualizacja sprawdzona wcześniej na kopii strony jest znacznie mniej emocjonująca niż testowanie jej działania bezpośrednio na witrynie, na której właśnie znajdują się Twoi klienci.

Błąd maintenance w WordPress. Podsumowanie

Komunikat maintenance może wyglądać groźnie, szczególnie kiedy pojawia się zaraz po kliknięciu przycisku aktualizacji i znika cała zawartość strony. W większości przypadków pierwszy etap naprawy jest jednak prosty. Otwierasz pliki WordPressa, znajdujesz .maintenance i usuwasz go.

Najważniejsze jest to, co zrobisz później. Sprawdź, czy aktualizacja rzeczywiście się zakończyła, przetestuj najważniejsze funkcje strony i nie uruchamiaj kolejnych zmian, dopóki nie masz pewności, że WordPress działa prawidłowo.

Warto też zadbać o zaplecze, zanim pojawi się kolejna awaria. Regularne kopie zapasowe, aktualizacje wykonywane w kontrolowany sposób i hosting przygotowany do obsługi WordPressa potrafią oszczędzić sporo czasu wtedy, gdy coś pójdzie niezgodnie z planem.

Twój WordPress zasługuje na hosting przygotowany właśnie pod ten CMS.
Sprawdź ofertę cyber_Folks i wybierz rozwiązanie dopasowane do swojej strony.