404 po migracji lub aktualizacji? Jak szybko przywrócić permalinki WordPress

Migracja strony na nowy serwer, aktualizacja WordPressa lub zmiana konfiguracji witryny to momenty, w których czasem pojawiają się niespodziewane problemy. Jednym z częstszych jest sytuacja, gdy część podstron nagle zaczyna zwracać błąd 404 Not Found, mimo że jeszcze chwilę wcześniej wszystko działało poprawnie. Najszybsza naprawa polega zazwyczaj na ponownym zapisaniu ustawień bezpośrednich odnośników w panelu WordPressa. Jeśli to nie pomoże, trzeba sprawdzić jeszcze plik .htaccess, cache i konfigurację serwera.

Co ciekawe, bardzo często w takiej sytuacji strona główna działa bez problemu, a błąd pojawia się tylko przy próbie wejścia w konkretne wpisy, strony lub produkty w sklepie. Na pierwszy rzut oka może to wyglądać jak poważna awaria, ale w rzeczywistości przyczyna bywa bardzo prosta. W wielu przypadkach winne są po prostu permalinki WordPressa, czyli struktura adresów URL. Dobra wiadomość jest taka, że naprawa tego problemu zwykle zajmuje dosłownie kilkadziesiąt sekund 😊 

Z tego artykułu dowiesz się:

Czym właściwie są permalinki w WordPressie? 

Permalinki to sposób, w jaki WordPress buduje adresy URL prowadzące do poszczególnych treści na stronie. To właśnie one decydują o tym, czy adres wpisu wygląda w czytelny sposób, czy jest jedynie ciągiem znaków i parametrów. 

Dla przykładu wpis na blogu może mieć adres w postaci: 

• twojadomena.pl/jak-zoptymalizowac-strone 

albo mniej przyjazny dla użytkownika adres techniczny: 

• twojadomena.pl/?p=123 

Większość właścicieli stron korzysta z pierwszego rozwiązania, ponieważ jest ono bardziej zrozumiałe dla odwiedzających i korzystniejsze z punktu widzenia SEO. 
WordPress pozwala ustawić taką strukturę w panelu administracyjnym, a następnie zapisuje odpowiednie reguły w konfiguracji strony. 

Jednak za prawidłowe działanie permalinków odpowiada nie tylko sam WordPress, ale również reguły przepisywania adresów zapisane w pliku .htaccess na serwerze. Jeśli z jakiegoś powodu przestaną one być zgodne z ustawieniami WordPressa, mogą pojawić się właśnie błędy 404. 

Dlaczego po migracji lub aktualizacji pojawia się błąd 404? 

Błąd 404 po migracji strony lub aktualizacji WordPressa wcale nie musi oznaczać, że treści zostały usunięte. Mogą one nadal znajdują się w bazie danych i być dostępne w panelu administracyjnym. Problem polega jedynie na tym, że WordPress nie potrafi poprawnie dopasować adresu URL do odpowiedniej treści. 

Może się tak wydarzyć z kilku powodów:

• Podczas migracji strony na nowy hosting nie zawsze zostają przeniesione wszystkie pliki konfiguracyjne w identycznej formie.
• Zdarza się również, że po zmianie środowiska serwerowego reguły przepisywania adresów przestają działać tak jak wcześniej. 
• Podobna sytuacja może wystąpić po aktualizacji WordPressa, wtyczki lub motywu. Niektóre rozszerzenia ingerują w strukturę adresów URL i po aktualizacji mogą chwilowo powodować konflikt w konfiguracji. 

Efekt jest zawsze bardzo podobny. WordPress nie potrafi dopasować adresu do właściwej treści i zamiast strony wyświetla komunikat 404 Not Found. 

Najprostsze rozwiązanie to odświeżenie ustawień permalinków 

Na szczęście w zdecydowanej większości przypadków naprawa jest bardzo szybka i nie wymaga żadnych zmian w kodzie strony ani dostępu do serwera. Wystarczy zalogować się do panelu administracyjnego WordPressa, a następnie przejść do sekcji:
Ustawienia -> Bezpośrednie odnośniki:

Na tej stronie znajduje się konfiguracja struktury adresów URL. Co ważne, w wielu przypadkach nie trzeba niczego zmieniać w ustawieniach. Wystarczy kliknąć przycisk „Zapisz zmiany”. 
Choć może to wyglądać jak drobna czynność, w rzeczywistości WordPress wykonuje wtedy ważną operację. System ponownie generuje reguły przepisywania adresów i zapisuje je w konfiguracji strony. Dzięki temu adresy URL zaczynają być poprawnie interpretowane przez serwer. W praktyce oznacza to, że po zapisaniu ustawień bardzo często wszystkie podstrony natychmiast zaczynają działać poprawnie. 

Gdy problem nadal występuje sprawdź plik .htaccess 

Jeżeli odświeżenie permalinków nie przyniosło rezultatu, warto sprawdzić jeszcze jeden element konfiguracji – plik .htaccess. Jest to plik znajdujący się w katalogu głównym strony na serwerze, który odpowiada za wiele reguł działania witryny, w tym za obsługę przyjaznych adresów URL. 

Podczas migracji strony zdarza się, że plik ten zostaje nadpisany, usunięty lub zmodyfikowany. W takiej sytuacji WordPress nie ma gdzie zapisać reguł odpowiedzialnych za działanie permalinków. 

Domyślna konfiguracja WordPressa w pliku .htaccess wygląda w uproszczeniu tak: 

# BEGIN WordPress 
RewriteEngine On 
RewriteBase / 
RewriteRule ^index\.php$ - [L] 
RewriteCond %{REQUEST_FILENAME} !-f 
RewriteCond %{REQUEST_FILENAME} !-d 
RewriteRule . /index.php [L] 
# END WordPress 

Jeżeli w pliku brakuje tych reguł lub plik jest pusty, warto je przywrócić. Po zapisaniu zmian dobrze jest ponownie wejść do ustawień permalinków w panelu WordPressa i jeszcze raz kliknąć „Zapisz zmiany”, aby upewnić się, że konfiguracja została odświeżona. 

Inne sytuacje, które mogą powodować błąd 404 

Choć problem z permalinkami jest najczęstszą przyczyną błędów 404 po migracji lub aktualizacji, czasem źródło problemu może być inne. Zdarza się na przykład, że konflikt powoduje jedna z wtyczek. Dotyczy to szczególnie wtyczek związanych z SEO, cache lub bezpieczeństwem, które modyfikują sposób działania adresów URL. W takiej sytuacji pomocne może być chwilowe wyłączenie wtyczek i sprawdzenie, czy problem nadal występuje. 

Innym możliwym powodem jest cache strony. Jeśli po migracji aktywna jest wtyczka cache lub zewnętrzny system cache na serwerze, przeglądarka może wyświetlać starszą wersję strony z zapamiętanym błędem. Wyczyścienie cache często rozwiązuje ten problem. 

W rzadkich przypadkach przyczyną mogą być również dodatkowe reguły serwera, konfiguracja CDN lub zabezpieczenia, które blokują poprawne przepisywanie adresów. 

Podsumowując 

Choć błędy 404 po migracji strony zdarzają się stosunkowo często, można w prosty sposób zmniejszyć ryzyko ich wystąpienia. Dobrym nawykiem jest sprawdzenie działania najważniejszych podstron zaraz po zakończeniu migracji lub aktualizacji. Warto również pamiętać, że zapisanie ustawień permalinków w panelu WordPressa to jedna z pierwszych czynności, które warto wykonać po przeniesieniu strony na nowy serwer. Dzięki temu WordPress od razu generuje poprawne reguły przepisywania adresów. Dobrą praktyką jest także wykonywanie kopii zapasowych przed większymi zmianami w stronie. W razie problemów pozwala to szybko przywrócić poprzednią wersję witryny.