Błąd 404 w WordPress po zmianie permalinków potrafi rozwalić ruch z wyszukiwarki, popsuć linkowanie wewnętrzne i sprawić, że strona wygląda, jakby nagle zniknęła z internetu. Najgorsze jest to, że problem często nie wynika z jednego oczywistego błędu, tylko z kilku drobnych rzeczy naraz: ustawień permalinków, pliku .htaccess, cache, konfliktu wtyczek, źle działającego serwera albo migracji, która nie przeniosła reguł adresów URL tak, jak powinna.
Jeśli po zmianie struktury adresów w WordPressie część podstron zwraca 404, a inne działają normalnie, nie panikuj. To zwykle da się naprawić bez przebudowy całej witryny. Ważne jest jednak, aby działać metodycznie i nie próbować losowo klikać kolejnych opcji, bo można tylko pogłębić problem. W tym artykule pokazuję, jak rozpoznać przyczynę, jak odróżnić problem w WordPressie od problemu na poziomie serwera i jak bezpiecznie przywrócić działanie linków.
Szybka odpowiedź
Jeżeli po zmianie permalinków pojawiły się błędy 404, zacznij od tych czterech kroków:
- Wejdź w Ustawienia > Bezpośrednie odnośniki i po prostu zapisz ustawienia ponownie, nawet jeśli nic nie zmieniasz.
- Sprawdź, czy plik .htaccess istnieje i czy WordPress może go zapisać.
- Wyczyść cache wtyczki, przeglądarki i ewentualnie cache po stronie serwera lub hostingu.
- Wyłącz na chwilę wtyczki od SEO, cache, bezpieczeństwa i przekierowań, aby wykluczyć konflikt reguł.
Jeśli problem występuje po migracji strony, zmianie domeny, przeniesieniu na inny hosting albo instalacji nowej wtyczki do przekierowań, przyczyna może leżeć nie w permalinkach, tylko w regułach przepisywania adresów, konfiguracji serwera lub błędnych redirectach. W takim przypadku nie warto działać na ślepo.
Diagnoza problemu
Najpierw trzeba ustalić, co dokładnie zwraca 404. To brzmi banalnie, ale ma duże znaczenie. Inaczej naprawia się sytuację, w której nie działa tylko kilka wpisów blogowych, inaczej problem całej kategorii, a jeszcze inaczej przypadek, gdy każda podstrona poza stroną główną pokazuje błąd 404.
Sprawdź trzy rzeczy:
- czy 404 pojawia się na wszystkich podstronach, czy tylko na wybranych;
- czy problem dotyczy tylko wpisów, stron, kategorii, tagów, czy też custom post types;
- czy błąd zaczął się po zmianie permalinków, aktualizacji wtyczki, migracji lub zmianie hostingu.
Jeżeli po wejściu na przykładowy adres wpisu WordPress pokazuje stronę 404, ale panel administracyjny działa normalnie, to zwykle problem jest po stronie reguł serwera lub struktury permalinków. Jeżeli natomiast 404 pojawia się tylko na części starych adresów, możliwe, że brakuje przekierowań 301 z dawnych URL-i na nowe.
Warto też rozróżnić błąd WordPressa od błędu serwera. Czasem strona 404 jest generowana przez sam motyw lub przez Apache/Nginx, a czasem przez WordPress po prostu nie znajduje pasującego wpisu. To dwie różne sytuacje, choć dla użytkownika wyglądają podobnie.
Jeżeli masz dostęp do narzędzi typu logi serwera, panel hostingu lub konsola przeglądarki, zwróć uwagę, czy odpowiedź serwera ma status 404, czy może 301/302 prowadzi w pętlę, albo 500 wskazujący na błąd PHP. To bardzo pomaga w zawężeniu problemu.
Możliwe przyczyny
Najczęstsze przyczyny błędów 404 po zmianie permalinków w WordPressie są zaskakująco powtarzalne. Oto te, które pojawiają się najczęściej w realnych wdrożeniach:
1. Nieodświeżone reguły permalinków
WordPress czasem potrzebuje ponownego zapisania ustawień, aby wygenerować aktualne reguły przepisywania adresów. Po zmianie struktury URL stary zestaw reguł może nadal działać w tle i kierować ruch w pustkę.
2. Uszkodzony lub nieprawidłowy plik .htaccess
W systemach opartych o Apache to jeden z głównych punktów zapalnych. Jeśli plik został nadpisany, ma błędną składnię albo serwer nie może go odczytać, WordPress nie będzie poprawnie przepisywał linków.
3. Konflikt z wtyczką SEO, cache lub przekierowań
Wtyczki potrafią dodawać własne reguły rewrite. Jeśli dwie różne wtyczki próbują zarządzać tym samym obszarem, efektem mogą być losowe 404, pętle przekierowań albo działające tylko niektóre typy treści.
4. Zmiana struktury permalinków bez przekierowań
Jeżeli zmieniłeś adresy wpisów, a stary ruch nadal trafia na stare URL-e, użytkownicy i roboty Google dostaną 404. To nie zawsze jest błąd techniczny, ale z punktu widzenia SEO to poważny problem.
5. Problem z uprawnieniami do pliku lub katalogu
WordPress i serwer muszą mieć możliwość odczytu i ewentualnego zapisu do kluczowych plików. Złe uprawnienia mogą blokować aktualizację reguł.
6. Błędna konfiguracja serwera po migracji
Po przeniesieniu strony na nowy hosting reguły Apache lub Nginx mogą nie być skonfigurowane tak, jak poprzednio. Wtedy WordPress wygląda na poprawnie działający, ale adresy nie są przepisywane prawidłowo.
7. Cache serwera lub CDN pokazuje stare reguły
Po zmianie permalinków część warstwy cache może nadal serwować stare odpowiedzi, przez co część użytkowników widzi poprawne strony, a część 404.
8. Błędny format własnych typów treści lub taksonomii
Jeśli używasz custom post types, własnych slugów lub wtyczek budujących bardziej złożone adresy, jedna drobna zmiana w ustawieniach może wywołać masowe 404 dla całego typu treści.
9. Konflikt z motywem
Rzadziej, ale się zdarza. Motyw może nadpisywać zachowanie permalinków, zwłaszcza jeśli zawiera własne funkcje dla portfolio, produktów, eventów lub stron specjalnych.
10. Brak aktualnych przekierowań po migracji struktury URL
Nawet jeśli WordPress działa poprawnie, stara wersja strony w Google może nadal generować wejścia na nieistniejące adresy. Bez 301 użytkownik dostaje 404, a strona traci sygnały SEO.
Rozwiązanie krok po kroku
Poniżej znajdziesz bezpieczną kolejność działań. Wykonuj je po kolei, a nie wszystkie naraz. Jeśli po którymś kroku problem znika, nie przechodź dalej bez potrzeby.
1. Zrób kopię zapasową
Zanim cokolwiek zmienisz, wykonaj backup plików i bazy danych. To nie jest formalność. Jeśli masz już niestabilną stronę, dalsze eksperymenty bez kopii mogą utrudnić powrót do działania.
Ostrzeżenie: jeśli pracujesz na stronie produkcyjnej i ruch jest wysoki, najlepiej najpierw przetestować zmiany na środowisku stagingowym.
2. Sprawdź, czy problem rzeczywiście dotyczy permalinków
Wejdź w kilka różnych adresów: wpis, strona, kategoria, archiwum autora, pojedynczy produkt lub custom post type. Jeżeli tylko jedna grupa URL-i daje 404, problem jest prawdopodobnie lokalny, a nie globalny.
3. Ponownie zapisz ustawienia bezpośrednich odnośników
Otwórz Ustawienia > Bezpośrednie odnośniki, nie zmieniaj nic albo wybierz tę samą strukturę, którą już masz, i kliknij zapis. Ten prosty ruch wymusza przebudowanie reguł rewrite.
Jeżeli po tym kroku strona zaczyna działać, problem był najpewniej w odświeżeniu reguł. To najłatwiejszy i najczęstszy przypadek.
4. Sprawdź .htaccess
Jeśli używasz Apache, otwórz plik .htaccess w katalogu głównym WordPressa i porównaj go z typową konfiguracją WordPressa. Plik powinien zawierać standardowe reguły odpowiadające za przepisywanie adresów.
Jeśli pliku nie ma, WordPress może próbować go utworzyć po zapisaniu permalinków. Jeśli istnieje, ale wygląda podejrzanie, mógł zostać nadpisany przez inną wtyczkę lub ręczną edycję.
Ostrzeżenie: nie wklejaj losowych reguł z internetu bez zrozumienia ich działania. Jedna literówka w .htaccess potrafi wyłączyć część lub całość strony.
5. Wyczyść wszystkie warstwy cache
Jeśli używasz wtyczki cache, CDN, hostingu z cache serwerowym albo cache przeglądarki, wyczyść je wszystkie. W przeciwnym razie możesz myśleć, że problem nadal istnieje, podczas gdy widzisz tylko starą odpowiedź z pamięci podręcznej.
Po czyszczeniu cache sprawdź stronę w oknie incognito i na innym urządzeniu lub w innej sieci.
6. Wyłącz wtyczki potencjalnie wpływające na adresy URL
Na próbę wyłącz kolejno lub grupowo wtyczki:
- SEO;
- cache;
- bezpieczeństwa;
- przekierowań;
- custom post types;
- builderów stron, jeśli generują własne archiwa lub dynamiczne URL-e.
Następnie sprawdź, czy 404 zniknęły. Jeżeli tak, włączaj wtyczki po jednej, aby znaleźć konflikt.
7. Zweryfikuj ustawienia serwera
Jeśli masz dostęp do hostingu, sprawdź, czy serwer obsługuje przepisywanie adresów. Na Apache musi działać odpowiedni moduł, a na Nginx potrzebna jest reguła rewrite w konfiguracji serwera. Po migracji strona może działać częściowo, ale bez prawidłowego przepisywania URL-i będą pojawiać się 404.
Jeśli nie masz dostępu do konfiguracji serwera, poproś hosting o potwierdzenie, że rewrite działa poprawnie.
8. Sprawdź własne typy treści i taksonomie
Jeżeli 404 dotyczy tylko określonego typu wpisów, sprawdź ustawienia custom post type. Zmiana slugów, bazy kategorii lub archiwum może sprawić, że stare adresy przestaną odpowiadać.
Ważne jest też, czy wtyczka tworząca custom post type nie została zaktualizowana do wersji zmieniającej strukturę URL.
9. Dodaj przekierowania 301 dla starych adresów
Jeżeli zmieniłeś strukturę permalinków, samo działanie nowych URL-i nie wystarczy. Stare linki powinny prowadzić do nowych adresów przez przekierowanie 301. Dzięki temu użytkownik nie trafia na 404, a Google przenosi część sygnałów SEO na nowe podstrony.
Uwaga bezpieczeństwa: przekierowania dodawaj ostrożnie. Zbyt duża liczba przekierowań, błędne reguły lub pętle 301/302 mogą spowolnić stronę i utrudnić indeksację.
10. Sprawdź logi błędów
Jeśli problem nie ustępuje, zajrzyj do logów serwera lub logów WordPressa. Często pokazują dokładnie, co się wywala: brakujący plik, błąd składni, konflikt funkcji albo problem z przepisaniem reguły. To jeden z najszybszych sposobów na przejście z domysłów do konkretu.
11. Odtwórz konflikt metodą eliminacji
Jeśli nadal nie masz rozwiązania, wyłącz wszystkie wtyczki poza absolutnie koniecznymi i przełącz motyw na domyślny. Jeśli 404 znikają, wiesz, że winny jest motyw lub jedna z wtyczek. Jeśli nie znikają, problem leży niżej: w serwerze, bazie, regułach rewrite lub konfiguracji hostingu.
12. Przywróć poprawną strukturę i przetestuj wszystko
Po naprawie sprawdź nie tylko pojedynczy URL, ale całą strukturę: wpisy, strony, kategorie, tagi, archiwa, produkty i media, jeśli są objęte własnymi regułami. Czasem jedna poprawka naprawia wpisy, ale psuje kategorie albo archiwa autora.
Najczęstsze błędy
W praktyce użytkownicy WordPressa najczęściej popełniają te same błędy, przez które naprawa trwa dłużej niż powinna:
- zmieniają permalink i od razu uznają, że strona się „zepsuła”, zamiast odświeżyć reguły;
- kasują losowo pliki serwera, zamiast sprawdzić .htaccess lub konfigurację Nginx;
- nie czyszczą cache, przez co widzą stare błędy;
- instalują kolejną wtyczkę do przekierowań, zamiast znaleźć przyczynę konfliktu;
- ignorują stare adresy z Google i nie dodają 301;
- testują problem tylko na stronie głównej, a nie na rzeczywistych adresach problematycznych;
- edytują .htaccess bez kopii zapasowej;
- zakładają, że skoro panel admina działa, to wszystko inne też musi działać;
- po migracji nie sprawdzają, czy serwer obsługuje rewrite;
- nie rozróżniają problemu z permalinkami od problemu z motywem lub wtyczką SEO.
Najbardziej kosztowny błąd to działanie bez planu. W przypadku 404 po zmianie permalinków szybka, ale chaotyczna ingerencja często kończy się tym, że zamiast jednego problemu masz trzy.
Kiedy nie robić tego samodzielnie
Nie wszystkie przypadki warto naprawiać „na czuja”. Lepiej nie podejmować samodzielnych prób, jeśli:
- strona ma duży ruch i każda minuta niedostępności oznacza realne straty;
- problem pojawił się po migracji między serwerami lub po zmianie konfiguracji hostingu;
- nie masz kopii zapasowej bazy i plików;
- 404 występuje masowo na całej stronie, a nie tylko na pojedynczych URL-ach;
- na stronie działają płatności, formularze, panel klienta lub inne krytyczne funkcje;
- korzystasz z rozbudowanego układu custom post types, wielojęzyczności lub zaawansowanych reguł przekierowań;
- nie masz dostępu do logów, plików serwera albo konfiguracji Nginx/Apache.
W takich sytuacjach każde nieprzemyślane działanie może wydłużyć przestój, a nawet pogorszyć stan strony. Szczególnie uważać trzeba przy stronach sprzedażowych, gdzie 404 na produktach albo kategoriach może bezpośrednio obniżyć liczbę zamówień.
Kiedy zgłosić się do specjalisty
Wsparcie specjalisty jest wskazane, gdy:
- po wykonaniu podstawowych kroków 404 nadal wracają;
- problem dotyczy całej witryny lub wielu sekcji jednocześnie;
- po zapisaniu permalinków pojawia się pętla przekierowań albo błąd 500;
- strona była przenoszona między hostami, domenami lub środowiskami;
- po aktualizacji WordPressa lub wtyczek coś przestało działać bez jasnej przyczyny;
- potrzebujesz poprawnych przekierowań 301 i ochrony SEO;
- nie możesz pozwolić sobie na metodę prób i błędów.
Specjalista powinien umieć sprawdzić nie tylko WordPress, ale też warstwę serwera, logi błędów, cache, przekierowania i zgodność ustawień hostingu. Dobre podejście polega na szybkim ustaleniu źródła problemu, a nie na instalowaniu kolejnych „naprawiaczy”.
Podsumowanie
Błąd 404 po zmianie permalinków w WordPressie najczęściej nie oznacza katastrofy, tylko rozjechane reguły adresów, problem z plikiem .htaccess, konflikt wtyczek albo brak przekierowań po zmianie struktury URL. W wielu przypadkach wystarczy ponownie zapisać ustawienia bezpośrednich odnośników, wyczyścić cache i sprawdzić, czy serwer poprawnie przepisuje adresy. Jeśli to nie pomaga, trzeba przejść do analizy konfiguracji hostingu, wtyczek i logów.
Najważniejsze jest to, aby nie działać przypadkowo. Przed każdą zmianą zrób backup, sprawdzaj problem krok po kroku i nie ignoruj sygnałów, że źródło błędu może być poza samym WordPressem. Im szybciej zdiagnozujesz przyczynę, tym mniejsze straty w ruchu, SEO i konwersji.
CTA do kontaktu
Jeśli błędy 404 po zmianie permalinków wracają mimo podstawowych działań, nie ryzykuj dalszego psucia strony. Skontaktuj się z nami, a przeanalizujemy konfigurację WordPressa, wtyczek, cache i serwera, żeby ustalić prawdziwą przyczynę i przywrócić działanie URL-i bez zgadywania.
