Aktualizacja WordPress zawisła na połowie – jak to naprawić?

Wprowadzenie – zawieszona aktualizacja

Zawieszona aktualizacja WordPressa to koszmar każdego administratora strony. Ekran aktualizacji zatrzymuje się w połowie procesu, a strona staje się niedostępna lub wyświetla komunikat o trybie konserwacji. Ten problem może wystąpić z wielu powodów – od limitów serwera po konflikty z wtyczkami.

Według statystyk, około 23% administratorów WordPressa przynajmniej raz spotkało się z problemem zawieszonej aktualizacji. Najczęściej dzieje się to podczas aktualizacji głównej wersji WordPressa, ale może dotyczyć również wtyczek i motywów.

W tym przewodniku przeprowadzę Cię przez wszystkie kroki potrzebne do naprawy zawieszonej aktualizacji – od wyłączenia trybu konserwacji, przez ręczną aktualizację, po przywracanie strony z backupu. Dowiesz się również, jak zapobiegać takim problemom w przyszłości.

Tryb konserwacji – jak wyłączyć

Gdy aktualizacja WordPressa się zawiesza, system automatycznie włącza tryb konserwacji, aby chronić stronę przed uszkodzeniem. Strona wyświetla wtedy komunikat: "Krótko niedostępna z powodu planowanej konserwacji. Sprawdź za chwilę."

Metoda 1: Usunięcie pliku .maintenance

Najprostszy sposób na wyłączenie trybu konserwacji to ręczne usunięcie pliku .maintenance:

1. Zaloguj się do swojego serwera przez FTP lub menedżer plików w panelu hostingowym
2. Przejdź do głównego katalogu instalacji WordPressa
3. Znajdź plik o nazwie .maintenance
4. Usuń ten plik
5. Odśwież stronę – powinna już działać normalnie

Metoda 2: Zmiana nazwy plików aktualizacji

Czasami oprócz pliku .maintenance WordPress tworzy również tymczasowe pliki aktualizacji:

1. W głównym katalogu WordPressa znajdź pliki zaczynające się od .maintenance lub wordpress-
2. Zmień ich nazwy, dodając przyrostek .old (np. .maintenance.old)
3. Usuń również plik upgrade.php z folderu wp-admin/includes jeśli istnieje

Metoda 3: Wyłączenie trybu konserwacji przez kod

Gdy powyższe metody nie działają, możesz wyłączyć tryb konserwacji przez dodanie kodu do pliku wp-config.php:

1. Otwórz plik wp-config.php w głównym katalogu WordPressa
2. Dodaj na końcu pliku, przed require_once, następujący kod:

define('WP_MAINTENANCE_MODE', false);

3. Zapisz plik i odśwież stronę

Ręczna aktualizacja przez FTP

Gdy udało Ci się wyłączyć tryb konserwacji, ale aktualizacja nadal się nie powiodła, czas na ręczną aktualizację WordPressa przez FTP.

Krok 1: Pobierz najnowszą wersję WordPressa

1. Wejdź na oficjalną stronę wordpress.org
2. Pobierz najnowszą wersję WordPressa w formacie .zip
3. Rozpakuj archiwum na swoim komputerze

Krok 2: Przygotuj się do aktualizacji

Zanim zaczniesz wgrywać pliki, wykonaj kopię zapasową:

1. Zrób kopię całego katalogu WordPressa przez FTP
2. Wyeksportuj bazę danych przez phpMyAdmin
3. Zapisz kopię w bezpiecznym miejscu

Krok 3: Wgraj nowe pliki

1. Połącz się z serwerem przez FTP
2. Usuń foldery wp-admin i wp-includes ze starej instalacji
3. Nie usuwaj folderu wp-content – zawiera Twoje wtyczki, motywy i media
4. Wgraj nowe foldery wp-admin i wp-includes z pobranej wersji
5. Wgraj wszystkie pliki z głównego katalogu oprócz wp-config.php

Krok 4: Zakończ aktualizację

1. Wejdź do panelu administracyjnego WordPressa
2. Jeśli pojawi się ekran aktualizacji bazy danych, kliknij "Zaktualizuj bazę danych"
3. Sprawdź, czy wszystkie funkcje strony działają poprawnie

Sprawdzenie wersji w bazie danych

Czasami po zawieszonej aktualizacji wersja WordPressa w plikach nie zgadza się z wersją zapisaną w bazie danych. Może to powodować błędy i problemy z działaniem strony.

Sprawdzenie wersji w bazie danych

1. Zaloguj się do phpMyAdmin przez panel hostingowy
2. Wybierz bazę danych używaną przez WordPressa
3. Znajdź tabelę wp_options
4. Wyszukaj opcje db_version i db_upgraded

Aktualizacja wersji w bazie danych

Jeśli wersje nie zgadzają się, możesz je ręcznie zaktualizować:

1. Sprawdź, jaka wersja WordPressa jest zainstalowana (w pliku version.php w folderze wp-includes)
2. W phpMyAdmin znajdź opcję db_version w tabeli wp_options
3. Zaktualizuj wartość na numer wersji z pliku version.php
4. Znajdź opcję db_upgraded i ustaw wartość na 1

Weryfikacja spójności bazy danych

Po aktualizacji wersji w bazie danych:

1. Uruchom narzędzie do naprawy bazy danych (dodaj ?repair=1 do URL strony)
2. Sprawdź, czy wszystkie tabele są poprawne
3. Wyczyść cache strony i przeglądarki

Backup przed aktualizacją

Jedną z najważniejszych zasad bezpieczeństwa podczas aktualizacji WordPressa jest posiadanie aktualnej kopii zapasowej. Zawieszona aktualizacja może uszkodzić pliki lub bazę danych, dlatego backup jest niezbędny.

Tworzenie kopii plików

1. Połącz się z serwerem przez FTP lub SSH
2. Pobierz cały katalog WordPressa na lokalny komputer
3. Upewnij się, że pobrano wszystkie pliki, w tym ukryte (zaczynające się od kropki)
4. Stwórz archiwum .zip z pobranymi plikami

Tworzenie kopii bazy danych

1. Zaloguj się do phpMyAdmin przez panel hostingowy
2. Wybierz bazę danych WordPressa
3. Kliknij zakładkę "Eksportuj"
4. Wybierz metodę "Szybka - pokaż minimalne opcje"
5. Format: SQL
6. Zaznacz "Zapisz jako plik"
7. Kliknij "Wykonaj"

Automatyczne narzędzia backupowe

Dla większej wygody i bezpieczeństwa warto zainstalować wtyczkę do automatycznych backupów:

• UpdraftPlus – najpopularniejsza wtyczka backupowa
• All-in-One WP Migration – proste narzędzie do migracji i backupu
• Duplicator – tworzy kopie i pakiety migracyjne

Przechowywanie backupów

Pamiętaj o zasadzie 3-2-1 przechowywania kopii zapasowych:

• 3 kopie – oryginał + dwie kopie zapasowe
• 2 różne media – lokalny dysk + chmura
• 1 kopia poza siedzibą – w innej lokalizacji geograficznej

Timeout i limity PHP

Jedną z najczęstszych przyczyn zawieszonych aktualizacji WordPressa są limity PHP – zbyt krótki czas wykonania skryptu lub zbyt mała pamięć allocated.

Problem z czasem wykonania (max_execution_time)

Domyślnie PHP ma ustawiony limit czasu wykonania skryptu na 30-60 sekund. Aktualizacja WordPressa, zwłaszcza dużych stron, może wymagać więcej czasu.

Rozwiązania:

1. Zwiększenie limitu w pliku php.ini:

   max_execution_time = 300

2. Zwiększenie limitu w pliku .htaccess:

   php_value max_execution_time 300

3. Zwiększenie limitu w pliku wp-config.php:

   set_time_limit(300);

Problem z limitem pamięci (memory_limit)

WordPress podczas aktualizacji może potrzebować więcej pamięci niż domyślne 128M.

Rozwiązania:

1. Zwiększenie limitu w pliku php.ini:

   memory_limit = 512M

2. Zwiększenie limitu w pliku .htaccess:

   php_value memory_limit 512M

3. Zwiększenie limitu w pliku wp-config.php:

   define('WP_MEMORY_LIMIT', '512M');

Inne limity PHP

Dodatkowo sprawdź i ewentualnie zwiększ:

• upload_max_filesize – maksymalny rozmiar wgrywanego pliku
• post_max_size – maksymalny rozmiar danych POST
• max_input_time – maksymalny czas przetwarzania danych wejściowych

Weryfikacja limitów PHP

Aby sprawdzić aktualne limity PHP:

1. W panelu WordPressa przejdź do Narzędzia → Stan zdrowia witryny
2. Zakładka "Informacje" → "Serwer"
3. Sprawdź wartości limitów PHP

Aktualizacja pluginów i motywów

Zawieszona aktualizacja może dotyczyć nie tylko samego WordPressa, ale również wtyczek i motywów. Problemy z aktualizacjami dodatków są równie częste.

Diagnozowanie problemów z aktualizacją wtyczek

Najczęstsze przyczyny problemów z aktualizacją wtyczek:

• Konflikty między wtyczkami – niektóre wtyczki mogą interferować z procesem aktualizacji
• Niekompatybilne wersje PHP – nowsza wersja wtyczki może wymagać nowszej wersji PHP
• Ograniczenia serwera – limity pamięci lub czasu wykonania
• Uszkodzone pliki – niekompletne lub uszkodzone archiwum aktualizacji

Ręczna aktualizacja wtyczki

1. Pobierz najnowszą wersję wtyczki z repozytorium WordPressa
2. Przez FTP usuń folder wtyczki z katalogu wp-content/plugins
3. Wgraj nową wersję wtyczki
4. Aktywuj wtyczkę ponownie w panelu WordPressa

Ręczna aktualizacja motywu

1. Pobierz najnowszą wersję motywu
2. Przez FTP usuń folder motywu z katalogu wp-content/themes
3. Wgraj nową wersję motywu
4. Sprawdź, czy motyw działa poprawnie

Bezpieczna aktualizacja motywu potomnego

Jeśli używasz motywu potomnego (child theme):

1. Aktualizuj tylko motyw nadrzędny (parent theme)
2. Nie usuwaj folderu motywu potomnego
3. Sprawdź, czy zmiany w motywie nadrzędnym nie łamią funkcjonalności motywu potomnego

Przywracanie z backupu

Gdy wszystkie próby naprawy zawieszonej aktualizacji zawiodą, ostatnią deską ratunku jest przywrócenie strony z kopii zapasowej.

Kiedy przywracać z backupu?

Przywracanie z backupu jest konieczne, gdy:

• Strona jest całkowicie niedostępna
• Po próbie naprawy pojawiają się nowe błędy
• Baza danych jest uszkodzona
• Kluczowe pliki WordPressa zostały uszkodzone

Przywracanie plików

1. Połącz się z serwerem przez FTP
2. Usuń wszystkie pliki WordPressa z serwera (z wyjątkiem wp-config.php)
3. Wgraj pliki z kopii zapasowej
4. Sprawdź uprawnienia plików (755 dla folderów, 644 dla plików)

Przywracanie bazy danych

1. Zaloguj się do phpMyAdmin
2. Usuń wszystkie tabele w bieżącej bazie danych
3. Importuj plik SQL z kopii zapasowej
4. Poczekaj na zakończenie importu
5. Sprawdź, czy strona działa poprawnie

Weryfikacja po przywróceniu

Po przywróceniu z backupu:

1. Przejrzyj wszystkie strony pod kątem poprawności działania
2. Sprawdź, czy formularze działają poprawnie
3. Weryfikuj, czy e-commerce (jeśli dotyczy) działa
4. Przetestuj proces logowania i rejestracji

Zapobieganie problemom

Lepsze niż naprawianie problemów jest ich zapobieganie. Oto najlepsze praktyki, które minimalizują ryzyko zawieszenia aktualizacji WordPressa.

Regularne kopie zapasowe

Ustaw automatyczne kopie zapasowe:

• Dziennie – dla aktywnych blogów i sklepów
• Tygodniowo – dla stron statycznych
• Przed każdą aktualizacją – ręczny backup

Testowanie aktualizacji

Zawsze testuj aktualizacje na środowisku deweloperskim:

1. Stwórz kopię strony na subdomenie
2. Przeprowadź aktualizację na kopii
3. Sprawdź, czy wszystko działa poprawnie
4. Dopiero wtedy aktualizuj stronę produkcyjną

Optymalizacja serwera

Upewnij się, że serwer jest odpowiednio skonfigurowany:

• PHP 8.0 lub nowszy – dla lepszej wydajności
• Wystarczająca pamięć – minimum 512MB
• Długi czas wykonania – minimum 300 sekund
• Nowoczesny serwer HTTP – Nginx lub Apache 2.4+

Monitorowanie stanu strony

Zainstaluj narzędzia monitorujące:

• Uptime monitoring – powiadomienia o niedostępności
• Logi błędów – regularne sprawdzanie logów
• Health checks – wbudowane narzędzia WordPressa

Planowanie aktualizacji

Aktualizuj w sposób przemyślany:

1. Wybierz odpowiedni moment – poza godzinami szczytu
2. Informuj użytkowników – o planowanej przerwie
3. Miej plan awaryjny – na wypadek problemów
4. Dokumentuj proces – na przyszłość

Podsumowanie – bezpieczne aktualizacje

Zawieszona aktualizacja WordPressa to stresujący problem, ale z odpowiednim przygotowaniem i wiedzą można go szybko rozwiązać i zapobiec w przyszłości.

Najważniejsze kroki w razie problemu:

1. Wyłącz tryb konserwacji – usuwając plik .maintenance
2. Zrób kopię zapasową – jeśli jeszcze jej nie masz
3. Zaktualizuj ręcznie przez FTP – jeśli automatyczna aktualizacja zawiodła
4. Sprawdź wersję w bazie danych – dla spójności systemu
5. Przywróć z backupu – jako ostateczność

Checklista bezpiecznej aktualizacji:

Przed aktualizacją:

• Zrób pełną kopię zapasową (pliki + baza danych)
• Sprawdź kompatybilność wtyczek i motywu
• Wyczyść cache strony
• Wyłącz wtyczki cache

Podczas aktualizacji:

• Monitoruj proces aktualizacji
• Nie zamykaj przeglądarki przed zakończeniem
• Miej otwarte narzędzia diagnostyczne

Po aktualizacji:

• Sprawdź działanie strony
• Przetestuj kluczowe funkcje
• Uruchom ponownie wtyczki cache
• Wyczyść cache ponownie

Pamiętaj:

Aktualizacje WordPressa są niezbędne dla bezpieczeństwa, ale wymagają ostrożności. Zawsze miej aktualną kopię zapasową i plan awaryjny. Regularne aktualizacje są lepsze niż odkładanie ich na później – mniejsze aktualizacje rzadko powodują problemy.

Z odpowiednim przygotowaniem i wiedzą zawieszona aktualizacja przestaje być problemem, a staje się tylko chwilową niedogodnością.