Po aktualizacji WordPressa lub WooCommerce sklep nie zawsze przestaje działać w całości. Częściej zawodzi jeden fragment: dodawanie do koszyka, płatności, panel zamówień, integracja z kurierem albo automatyczne wiadomości. Najważniejsze jest szybkie ustalenie co przestało działać, kiedy i w jakich warunkach — bez wykonywania przypadkowych zmian w aktywnym sklepie.
Najpierw ustal, czy problem pojawił się po aktualizacji
Zapisz godzinę błędu i porównaj ją z historią aktualizacji WooCommerce, innych wtyczek, motywu i PHP. Przetestuj stronę jako zalogowany administrator oraz jako niezalogowany klient w osobnym oknie przeglądarki. Zwróć uwagę na:
- biały ekran lub komunikat „Na stronie wystąpił błąd krytyczny”,
- problemy tylko na stronie produktu, koszyka lub checkoutu,
- brak metod dostawy albo płatności mimo poprawnie skonfigurowanego produktu,
- zamówienia bez aktualizacji statusu po opłaceniu,
- niedziałające integracje i opóźnione zadania w tle.
Sam zbieg czasowy nie dowodzi, że winna jest ostatnio aktualizowana wtyczka. Przyczyną bywa cache, zmiana w zewnętrznym API, problem hostingu albo błąd pojawiający się jedynie przy konkretnym wariancie zakupu.
7 kroków naprawy WooCommerce po aktualizacji
1. Sprawdź zakres awarii i zabezpiecz nowe zamówienia
Jeżeli sklep przyjmuje zamówienia, nie przywracaj automatycznie pełnej kopii bazy danych sprzed aktualizacji. Taka operacja może nadpisać zamówienia i płatności złożone później. Przy częściowej awarii rozważ tymczasowe wyłączenie tylko uszkodzonej funkcji albo skierowanie klientów do działającej alternatywy.
2. Otwórz WooCommerce → Status → Logi
Sprawdź wpisy z czasu wystąpienia usterki. Szukaj powtarzających się komunikatów typu fatal error, błędu połączenia API, nieudanego webhooka i problemów przy zmianie statusu zamówienia. W przypadku błędu krytycznego PHP skorzystaj też z logów hostingu lub trybu odzyskiwania WordPressa.
3. Zweryfikuj przeglądarkę i żądania HTTP
W narzędziach programistycznych sprawdź zakładki Console i Network. Błędy JavaScript mogą blokować koszyk nawet wtedy, gdy serwer zwraca kod 200. Nieudane żądania /wp-json/ albo odpowiedzi 403/500 pomagają określić, czy problem dotyczy Store API, bezpieczeństwa, cache czy kodu PHP.
4. Porównaj klasyczny checkout z blokami WooCommerce
Wtyczki korzystające z tradycyjnych hooków checkoutu mogą wymagać osobnej obsługi blokowego koszyka i finalizacji zamówienia. Jeżeli błąd ujawnia się tylko na jednym wariancie, sprawdź zgodność wtyczek z HPOS i Checkout Blocks.
5. Odtwórz awarię na stagingu
Staging powinien mieć zbliżone wersje WordPressa, WooCommerce, motywu, PHP i dodatków. Wyłącz na nim realne płatności, maile transakcyjne oraz synchronizację zamówień z systemami firmowymi. Następnie wykonaj dokładnie tę samą sekwencję kliknięć, która powoduje błąd w produkcji.
6. Sprawdź konflikt albo regresję wersji
Na kopii sklepu wyłącz ostatnio zaktualizowany dodatek i powtórz test. Jeśli problem ustępuje, włącz go z powrotem i sprawdź, czy błąd wraca. Dla potwierdzonej regresji można rozważyć powrót do wcześniejszej, zaufanej paczki — ale tylko z planem przywrócenia i uwzględnieniem ewentualnych migracji bazy danych. Rollback plików nie zawsze cofa zmiany schematu danych.
7. Sprawdź wszystkie etapy zakupu przed zamknięciem zgłoszenia
Przeprowadź test produktu prostego i wariantowego, rabatu, dostawy, płatności testowej, wygenerowania zamówienia, e-maila i integracji. Jeżeli awaria dotyczyła wysyłki powiadomień, zajrzyj też do poradnika WooCommerce nie wysyła e-maili o zamówieniu.
Czy można bezpiecznie cofnąć aktualizację?
Czasami tak, ale decyzja zależy od rodzaju zmiany. Powrót do starszej wtyczki bez przywracania bazy może wystarczyć, gdy zmienił się tylko interfejs. Jeżeli aktualizacja wprowadziła migrację zamówień, nowe pola lub zmieniła strukturę danych, powrót wymaga dokładnego planu. Nie wgrywaj losowych starszych paczek z nieznanych źródeł. Przeczytaj jak przygotować backup, staging i rollback.
Kiedy problemem jest pamięć podręczna?
Objawy takie jak nieaktualny licznik koszyka, zawartość koszyka innego użytkownika albo brak zmian po aktualizacji mogą wynikać z błędnego buforowania stron dynamicznych. Upewnij się, że koszyk, checkout i strony konta klienta nie są traktowane jak zwykłe, statyczne strony dla anonimowych użytkowników. Wyczyść właściwe warstwy cache, ale nie traktuj tego jako zamiennika diagnostyki.
FAQ: awarie WooCommerce po aktualizacji
Czy wyłączyć wszystkie wtyczki od razu?
Nie w aktywnym sklepie bez planu. Test wyłączania wykonuj na stagingu, zachowując działanie płatności i integracji na produkcji.
Czy ponowna instalacja WooCommerce naprawi koszyk?
Nie ma gwarancji. Jeśli przyczyną jest konflikt, konfiguracja lub błąd bazy danych, samo podmienienie plików może nie wystarczyć.
Co wysłać do pomocy technicznej?
Dokładne kroki odtworzenia błędu, godzinę, wersje WordPressa/WooCommerce/PHP, log bez danych klientów oraz informację o ostatnich aktualizacjach i testach.
Powiązane poradniki: jak znaleźć konflikt wtyczek WooCommerce i checklista testów przed wdrożeniem. Jeśli potrzebujesz wsparcia przy sklepie, zobacz opiekę WordPress i WooCommerce.
Dokumentacja: WooCommerce — testy konfliktów; WordPress — debugowanie.
