Magda
9 min
25 kwietnia, 2025

Najczęstsze błędy w WordPressie i jak je naprawić – przewodnik dla właścicieli stron

WordPress to bez wątpienia najpopularniejszy system zarządzania treścią na świecie. Swoją popularność zawdzięcza przede wszystkim prostocie obsługi, elastyczności oraz ogromnej społeczności. Ale nawet najlepiej zaprojektowany CMS nie jest wolny od błędów. W tym artykule poznasz najczęstsze problemy, z jakimi borykają się użytkownicy WordPressa, oraz dowiesz się, jak je skutecznie rozwiązać – bez stresu i bez paniki.

Czytaj więcej
Najczęstsze błędy w WordPressie i jak je naprawić – przewodnik dla właścicieli stron

1. Błąd połączenia z bazą danych

Zdarza się, że wchodzisz na swoją stronę, a tam widnieje tylko komunikat „Error establishing a database connection”. To klasyka. Ten błąd oznacza, że WordPress nie może nawiązać połączenia z bazą danych – a to z kolei sprawia, że cała witryna przestaje działać. Najczęściej przyczyną jest nieprawidłowa konfiguracja pliku wp-config.php. To właśnie tam zapisane są dane logowania do bazy danych: nazwa użytkownika, hasło, adres hosta oraz sama nazwa bazy. Wystarczy literówka lub zmiana hasła bez aktualizacji w pliku, aby wszystko przestało działać. Czasem winny jest też serwer – na przykład gdy baza danych została przeciążona albo chwilowo niedostępna.

Rozwiązanie? Zacznij od sprawdzenia pliku wp-config.php. Możesz też skontaktować się z działem wsparcia swojego hostingu – często są w stanie przywrócić połączenie lub wskazać źródło problemu. Opisujemy ten problem szczegółowo w artykule: Błąd łączenia z bazą danych – przyczyna, diagnoza, naprawa.

2. Biała strona śmierci (White Screen of Death)

Brzmi dramatycznie i… w sumie takie właśnie jest. Biała strona bez żadnego komunikatu błędu oznacza, że coś poszło bardzo źle. Często dzieje się to po aktualizacji motywu lub wtyczki. WordPress przestaje wyświetlać treść, ponieważ kod PHP generuje krytyczny błąd. Jednym ze sposobów na zdiagnozowanie problemu jest włączenie trybu debugowania. W pliku wp-config.php wystarczy dopisać linijkę:

define('WP_DEBUG', true);

Po odświeżeniu strony często pojawi się dokładny komunikat o błędzie. Najczęściej winowajcą jest jedna z wtyczek – dlatego warto dezaktywować wszystkie i sprawdzać, czy problem zniknął. Jeśli tak – aktywuj je pojedynczo, aż znajdziesz sprawcę.

3. Błąd 500 – Internal Server Error

To jeden z najbardziej ogólnych błędów. Może mieć dziesiątki przyczyn – od uszkodzonego pliku .htaccess, przez błędny motyw, aż po niewystarczające limity pamięci PHP.

Pierwszym krokiem powinno być usunięcie pliku .htaccess i wygenerowanie go ponownie z poziomu panelu WordPressa (Ustawienia > Bezpośrednie odnośniki > Zapisz zmiany). Jeśli to nie pomaga, warto zwiększyć limity PHP, np. przez dodanie do wp-config.php:

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

Warto też sprawdzić logi serwera – znajdziesz tam więcej informacji o tym, co dokładnie wywołało błąd.

Potrzebujesz wsparcia w projektach opartych o WordPress?
Potrzebujesz wsparcia w projektach opartych o WordPress?
Potrzebujesz wsparcia w projektach opartych o WordPress?
Napisz do nas!

4. Strona utknęła w trybie konserwacji

Podczas aktualizacji WordPressa, jego motywów albo wtyczek, system automatycznie włącza tzw. tryb konserwacji. To całkowicie normalne – na czas aktualizacji użytkownicy widzą komunikat: „Briefly unavailable for scheduled maintenance. Check back in a minute.” Zwykle trwa to dosłownie kilka sekund i znika samo.

Problem pojawia się wtedy, gdy coś przerywa aktualizację – na przykład serwer jest zbyt wolny, połączenie zostanie zerwane albo wystąpi błąd w aktualizowanej wtyczce. W takich sytuacjach WordPress nie zdąży usunąć pliku .maintenance, który tworzy automatycznie na czas aktualizacji. I efekt jest taki, że strona na stałe utknie w trybie konserwacji – bez względu na to, ile razy ją odświeżysz.

Na szczęście rozwiązanie jest proste. Trzeba po prostu zalogować się na serwer – najlepiej przez FTP lub menedżer plików w panelu hostingu – i wejść do głównego katalogu WordPressa (tam, gdzie są pliki takie jak wp-config.php czy folder wp-content). Tam znajdziesz plik .maintenance. Wystarczy go usunąć. Po tej operacji strona powinna natychmiast wrócić do normalnego działania.

Warto po tym sprawdzić, czy wszystkie aktualizacje się zakończyły – czasami przez przerwaną aktualizację wtyczka lub motyw mogą nie działać poprawnie. Jeśli coś nie gra, najlepiej zaktualizować je ręcznie albo przywrócić z kopii zapasowej.

5. Błąd 404 na stronach lub wpisach

Czasami może się zdarzyć, że strona główna Twojej witryny działa bez zarzutu, ale po kliknięciu w dowolny wpis lub podstronę użytkownik trafia na błąd 404 – czyli komunikat o nieistniejącej stronie. Najczęściej winne są tutaj bezpośrednie odnośniki (permalinki), które z jakiegoś powodu przestały działać prawidłowo.

Ten problem pojawia się zwykle po:

  • migracji strony na inny serwer lub domenę,
  • przywracaniu kopii zapasowej,
  • ręcznej edycji pliku .htaccess,
  • zmianie struktury odnośników w ustawieniach.

Rozwiązanie? Najprostszym i najczęściej skutecznym sposobem jest ponowne zapisanie ustawień bezpośrednich odnośników:

1. Zaloguj się do panelu WordPressa.

2. Przejdź do Ustawienia > Bezpośrednie odnośniki.

3. Kliknij przycisk „Zapisz zmiany”, nawet jeśli nic nie zmieniasz.

WordPress automatycznie wygeneruje nowy plik .htaccess, który powinien naprawić problem.

Jeśli to nie pomoże, upewnij się, że Twój serwer obsługuje mod_rewrite (w przypadku Apache) i że plik .htaccess ma odpowiednie uprawnienia (np. 644). W ostateczności możesz też spróbować ręcznie dodać standardowy kod .htaccess WordPressa – znajdziesz go w dokumentacji.

6. Błąd składniowy w kodzie PHP (Parse error)

Ten błąd pojawia się najczęściej po ręcznej edycji plików motywu, wtyczki lub samego WordPressa. Wystarczy drobna pomyłka – brak średnika, źle zamknięty nawias, literówka w nazwie funkcji – i strona przestaje działać, a zamiast niej widzisz komunikat w stylu: Parse error: syntax error, unexpected…

Ten komunikat zazwyczaj zawiera nazwę pliku i numer linii, w której wystąpił błąd – to cenna wskazówka, gdzie szukać problemu.

Najczęstsze przyczyny błędów składniowych:

  • brak średnika (;) na końcu instrukcji,
  • niezamknięty nawias () lub klamra {},
  • błędna składnia warunków (if, foreach, itd.),
  • nieprawidłowe użycie funkcji lub słów kluczowych,
  • kopiowanie kodu z internetu bez sprawdzenia poprawności.

Rozwiązanie? Przedstawiamy poniżej krok po kroku:

1. Zidentyfikuj plik i linię błędu na podstawie komunikatu.

2. Zaloguj się przez FTP lub menedżer plików w panelu hostingu.

3. Otwórz plik i sprawdź wskazaną linię – warto też zerknąć na kilka linijek przed nią.

4. Popraw błąd lub – jeśli nie wiesz, co zmieniłeś – przywróć wcześniejszą wersję pliku z kopii zapasowej.

Jeśli dostęp do kokpitu WordPressa jest zablokowany przez błąd, możesz też tymczasowo dezaktywować motyw lub wtyczkę przez zmianę nazwy ich folderu (np. twentytwentyonetwentytwentyone_old). To pozwoli przywrócić dostęp do panelu i dokonać dalszych napraw.

Dla bezpieczeństwa – przed ręczną edycją plików zawsze warto robić kopię zapasową. A jeśli nie czujesz się pewnie z kodem PHP – skorzystaj z edytora z podpowiedziami składni (np. VS Code), albo poproś o pomoc kogoś bardziej technicznego. Sprawdź nasz artykuł: Aktualizacja PHP w WordPressie.

7. Przekroczony maksymalny czas wykonania skryptu

Podczas instalacji wtyczki, importu dużej ilości danych lub migracji strony możesz zobaczyć błąd: Maximum execution time exceeded. To oznacza, że serwer przerwał działanie skryptu, bo trwało ono zbyt długo.

Możesz temu zaradzić, dodając do pliku .htaccess linijkę:

php_value max_execution_time 300

Lub edytując php.ini i zwiększając max_execution_time. Jeśli nie masz dostępu – skontaktuj się z hostingiem.

8. Błąd mieszanej zawartości (Mixed Content)

Po przejściu na HTTPS może się zdarzyć, że część zasobów (np. obrazki) nadal ładowana jest przez HTTP. Przeglądarki blokują takie elementy, co może powodować błędne wyświetlanie strony.

Rozwiązaniem jest zmiana wszystkich linków wewnętrznych na wersję HTTPS. Można to zrobić ręcznie, ale znacznie szybciej za pomocą wtyczki, np. Better Search Replace lub Really Simple SSL.

9. Nieudane automatyczne aktualizacje

Automatyczne aktualizacje WordPressa i jego komponentów to świetna funkcja, ale czasami zawodzą. Najczęściej z powodu zbyt krótkiego czasu wykonania lub błędów uprawnień.

W takiej sytuacji najlepiej przeprowadzić aktualizację ręcznie: pobrać najnowszą wersję WordPressa ze strony oficjalnej i nadpisać pliki na serwerze – z wyjątkiem katalogu wp-content i pliku wp-config.php. To pozwala zachować dane i konfigurację.

10. WordPress nie wysyła e-maili

Brak wiadomości z formularza kontaktowego, brak resetu hasła czy powiadomień – to częsty problem. Domyślna funkcja wp_mail() często nie działa na tańszych hostingach, które blokują maile z PHP.

Rozwiązaniem jest konfiguracja SMTP – możesz to zrobić np. za pomocą wtyczki WP Mail SMTP. Wymaga to podania danych do serwera SMTP (np. Gmail, Sendinblue czy Mailgun), ale daje gwarancję dostarczania wiadomości.

11. Zbyt duży plik przy imporcie lub przesyłaniu mediów

Jeśli próbujesz wrzucić duży plik – np. film lub plik kopii zapasowej – możesz zobaczyć komunikat o przekroczeniu limitu.

Warto wtedy edytować ustawienia PHP i zwiększyć wartości upload_max_filesize, post_max_size oraz memory_limit. Można to zrobić w pliku php.ini, .htaccess lub bezpośrednio w wp-config.php.

12. Pętla przekierowań

Gdy Twoja strona nie chce się załadować i przeglądarka zgłasza błąd przekierowania, problemem są najczęściej źle ustawione adresy witryny (WordPress Address i Site Address). Czasem też winna jest wtyczka SEO.

Sprawdź, czy adresy w panelu są zgodne z rzeczywistością (np. z https://, jeśli masz certyfikat SSL). W razie potrzeby wymuś je w wp-config.php:

define('WP_HOME','https://twojadomena.pl');
define('WP_SITEURL','https://twojadomena.pl');

13. Strona została zhakowana

Nie ma nic gorszego niż moment, gdy Twoja strona zaczyna przekierowywać użytkowników na podejrzane witryny, a Google oznacza ją jako niebezpieczną. Najczęściej ataki wynikają z nieaktualnych wtyczek lub motywów, braku zabezpieczeń i słabych haseł.

W pierwszej kolejności zeskanuj stronę – np. za pomocą narzędzia Sucuri lub wtyczki Wordfence. W przypadku infekcji: usuń zainfekowane pliki, przywróć kopię zapasową, zmień wszystkie hasła (do WordPressa, FTP, bazy danych). Na przyszłość – rozważ instalację firewalla, ograniczenie logowania i automatyczne kopie zapasowe WordPressa.

Podsumowanie

Choć WordPress jest przyjazny i intuicyjny, błędy są jego nieodłączną częścią – szczególnie przy dużej liczbie wtyczek i częstych zmianach. Kluczem do spokoju jest wiedza, szybkie reagowanie i regularne backupy.

Powiązane artykuły
Zobacz wszystkie
Odkryj więcej tematów