Błąd 503 na WordPress – jak naprawić internal server error?

Błąd 503 (Service Unavailable) na stronie internetowej to jeden z najczęstszych błędów serwera. Oznacza, że serwer chwilowo nie może obsłużyć zapytania i nie wyświetla strony. Zwykle wynika z przeciążenia albo limitów hostingu, trwającej aktualizacji lub błędów w skryptach wykonywanych przez system zarządzania treścią. Jego bliski kuzyn to błąd 500 (Internal Server Error), czyli ogólny błąd serwera; oba opisuję poniżej.

W skrócie: gdy strona na WordPressie zwraca błąd serwera, zacznij od pytania, co zmieniło się tuż przed awarią (aktualizacja, nowa wtyczka, edycja pliku, nagły ruch). Potem sprawdź error log na serwerze albo włącz debug log, wyłącz wtyczki, przywróć domyślny plik .htaccess i podnieś limit pamięci PHP. Jeśli strona pokazuje komunikat o konserwacji albo błąd pojawia się tylko w godzinach dużego ruchu, przyczyna leży zwykle w aktualizacji, która się nie dokończyła, albo w limitach hostingu. Wszystkie te kroki opisuję niżej.

Błąd 500 i błąd 503 - jak je odróżnić

W przeglądarce, w Google Search Console i w logach serwera zobaczysz dwa podobne kody. Oba oznaczają, że problem jest po stronie serwera, a nie po stronie odwiedzającego, ale podpowiadają coś innego:

Kod	Nazwa	Co oznacza	Typowe przyczyny w WordPressie	Pierwszy krok
500	Internal Server Error	serwer trafił na nieoczekiwany błąd i nie ma dla niego dokładniejszego kodu	błąd PHP we wtyczce lub motywie, za mały limit pamięci, uszkodzony .htaccess	error log serwera albo debug.log
503	Service Unavailable	serwer chwilowo nie jest gotowy obsłużyć zapytania	niedokończona aktualizacja (plik .maintenance), przeciążenie, limity procesów lub CPU na hostingu	sprawdź plik .maintenance i obciążenie konta w panelu hostingu

Definicje kodów: 500 Internal Server Error i 503 Service Unavailable w dokumentacji MDN. W praktyce nie każdy hosting trzyma się tego podziału: część serwerów przy przeciążeniu zwraca 500, 502 albo 504, dlatego kod traktuję jako wskazówkę, a przyczynę potwierdzam w logach.

Najczęstsze przyczyny błędu 503 i 500 na WordPressie

Błędy 503 mogą mieć wiele powodów od aspektów serwerowych, przez błędy w bazie danych po błędy w kodzie strony i całego systemu. Oto najpopularniejsze przyczyny błędu 503:

1. Błędy w kodzie strony internetowej mogą powodować, że serwer nie jest w stanie przetworzyć żądania i wyświetlić strony. Błędy te mogą być spowodowane przez niezgodność zasad kodowania lub niewłaściwe użycie funkcji.
2. Błąd 503 może być również spowodowany problemami z serwerem, takimi jak zbyt obciążony serwer, błędy konfiguracji lub problemy z plikami serwera.
3. Konflikty między pluginami mogą również prowadzić do błędu 503. Jeśli pluginy nie są zaktualizowane lub są niezgodne ze sobą, mogą powodować błędy na stronie.
4. Błąd 503 może być również spowodowany problemami z bazą danych, takimi jak brak połączenia z bazą danych, błędy w konfiguracji bazy danych lub błędy w zapytaniach do bazy danych.

Jak zidentyfikować błąd 500 na stronie WordPress?

Błąd 500 w przypadku wordpress’a wyświetla zwykle komunikat o krytycznym błędzie i wysyła maila na adres mailowy administratora z szablonowym postępowaniem.

W przypadku błędu po stronie działania serwera może nam się wyświetlić biały ekran z informacją Error 500 - internal server error. Taki komunika za dużo nam nie powie poza kodem błędu. Jednakże wtedy bardzo prawdopodobne jest, że błąd wynika bezpośrednio z serwera.

By zidentyfikować problem błędu 500 w WordPress warto włączyć debugowanie w pliku wp-config.php znajdującym się bezpośrednio w folderze z plikami wordpress’a.

Znajdź następujący fragment kodu w tym pliku (nad komentarzem „That’s all, stop editing”):

define( 'WP_DEBUG', false );

Następnie ten fragment możesz zmienić na:

define( 'WP_DEBUG', true );

Dodatkowo dopisz dwie linijki kodu: zapis błędów do pliku i ukrycie ich przed odwiedzającymi.

define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Dzięki nim utworzysz dziennik debugowania debug.log w folderze wp-content, wewnątrz folderu z plikami WordPressa, a błędy nie pojawią się na stronie.

Wyświetlanie błędów na ekranie włączaj tylko w środowisku lokalnym, czyli na kopii strony na własnym komputerze (na przykład w LocalWP), nigdy na działającej stronie. Na kopii lokalnej nie dopisuj drugiej linijki z tą samą stałą, bo PHP zachowa pierwszą wartość. Zamiast tego w przykładzie wyżej zamień false na true przy WP_DEBUG_DISPLAY i 0 na 1 przy display_errors:

// tylko kopia lokalna, nie serwer produkcyjny
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', true );
@ini_set( 'display_errors', 1 );

Na działającej stronie zostaw WP_DEBUG_DISPLAY na false, tak jak w przykładzie wyżej. Wtedy błędy trafią do pliku, a odwiedzający nie zobaczą ścieżek serwera i fragmentów kodu. Jak zapisać log poza katalogiem publicznym i jak go czytać, pokazuję w poradniku WordPress debug: jak włączyć i szukać błędów.

Dzięki tym zapisom w dzienniku błędów otrzymasz więcej szczegółowych informacji o błędzie i jego lokalizacji. To pozwoli Tobie lub programistom przywrócić działanie strony. Po diagnozie przywróć WP_DEBUG na false i usuń plik debug.log.

Jakie kroki warto podjąć jeśli nie możesz poradzić sobie z błędem 500 na WordPress?

Oto kilka podstawowych kroków, które warto wykonać w celu naprawy błędu lub wyświetlania się błędu. Nie zawsze wyświetlanie się błędu oznacza, że ten błąd występuje (to częste zjawisko w przypadku cacheowania się stron i przeglądarek).

• Wyczyść pamięć podręczną przeglądarki i WordPressa.
• Sprawdź, czy plik .htaccess jest uszkodzony i przywróć domyślne ustawienia.
• Zwiększ limit pamięci PHP w pliku wp-config.php lub przez plik php.ini.
• Wyłącz wszystkie wtyczki WordPressa i włączaj je pojedynczo, aby znaleźć tę, która powoduje błąd.
• Przełącz się na domyślny motyw WordPressa i sprawdź, czy błąd nadal występuje.
• Zaktualizuj lub prześlij ponownie pliki rdzenia WordPressa (wp-admin/ i wp-includes/).
• Włącz logi debugowania WordPressa, aby zobaczyć, co powoduje błąd.
• Skontaktuj się z dostawcą hostingu, aby uzyskać pomoc w identyfikacji przyczyny błędu.

Od czego zacząć

Gdy strona pokazuje tylko kod błędu albo pusty ekran, zajrzyj najpierw do logów: error logu serwera w panelu hostingu albo debug logu WordPressa. Błąd krytyczny, którego nie widać na stronie, zwykle jest tam zapisany razem ze ścieżką do konkretnego pliku, a ścieżka wskazuje wtyczkę albo motyw. Jeśli log milczy, potrzebny jest powtarzalny scenariusz: ustal, na jakiej stronie i w jakich warunkach błąd się pojawia, i odtwórz go z włączonym logowaniem. Jeśli WordPress wyświetla komunikat o błędzie krytycznym, opis postępowania znajdziesz w poradniku błąd krytyczny WordPress i konflikt wtyczek.

W kolejnych fragmentach przejdziemy bardziej szczegółowo przez każdy z tych błędów.

Wyświetlanie błędu 503 na WordPress a pamięć podręczna

Jednym z powodów występowania błędu 500 może być Twoja pamięć podręczna. Zarówno ta generowana na poziomie przeglądarki internetowej lub też ta generowana na poziomie dostawcy internetu czy już samego WordPress’a.

Jak wyczyścić pamięć podręczną w przeglądarce? Oto lista kroków w zależności od przeglądarki.

Pamięć podręczna - Google Chrome

1. Kliknij ikonę „More” (trzy pionowe kropki) w prawym górnym rogu przeglądarki.
2. Wybierz „More tools” (Narzędzia) -> „Clear browsing data” (Wyczyść dane przeglądania).
3. Wybierz okres, dla którego chcesz wyczyścić pamięć podręczną.
4. Wybierz rodzaje danych, które chcesz wyczyścić, np. „Cached images and files” (Zachowane obrazy i pliki) i „Cookies and other site data” (Ciasteczka i inne dane witryn).
5. Kliknij przycisk „Clear data” (Wyczyść dane).

Pamięć podręczna - Mozilla Firefox

1. Kliknij ikonę „Menu” (trzy poziome kreski) w prawym górnym rogu przeglądarki.
2. Wybierz „Options” (Opcje) -> „Privacy & Security” (Prywatność i bezpieczeństwo).
3. Przewiń w dół do sekcji „Cookies and Site Data” (Ciasteczka i dane witryn) i kliknij przycisk „Clear Data” (Wyczyść dane).
4. Wybierz rodzaje danych, które chcesz wyczyścić, np. „Cached Web Content” (Zachowane treści internetowe) i „Cookies and Site Data” (Ciasteczka i dane witryn).
5. Kliknij przycisk „Clear”.

Pamięć podręczna - Safari

1. Kliknij „Safari” w pasku menu.
2. Wybierz „Preferences” (Preferencje).
3. Przejdź do zakładki „Privacy” (Prywatność).
4. Kliknij przycisk „Manage Website Data” (Zarządzaj danymi witryn).
5. Wybierz rodzaje danych, które chcesz wyczyścić, np. „Cached Images and Files” (Zachowane obrazy i pliki) i „Cookies and Website Data” (Ciasteczka i dane witryn).
6. Kliknij przycisk „Remove All” (Usuń wszystko).

Pamięć podręczna - Microsoft Edge

1. Kliknij ikonę „Menu” (trzy kropki) w prawym górnym rogu przeglądarki.
2. Wybierz „Settings” (Ustawienia) -> „Privacy, search, and services” (Prywatność, wyszukiwanie i usługi).
3. Kliknij przycisk „Choose what to clear” (Wybierz, co wyczyścić) w sekcji „Clear browsing data”.
4. Wybierz rodzaje danych, które chcesz wyczyścić, np. „Cached images and files” (Zachowane obrazy i pliki) i „Cookies and other site data” (Ciasteczka i inne dane witryn).
5. Kliknij przycisk „Clear now” (Wyczyść teraz).

Po wyczyszczeniu pamięci podręcznej przeglądarki, wszystkie zachowane pliki i dane zostaną ususunięte, co może pomóc w rozwiązaniu problemów z wyświetlaniem stron internetowych lub zalogowaniem się na nie. Zachowaj jednak ostrożność by nie usunąć zbyt wiele ze swojej przeglądarki. Niektórych danych możesz już nie odzyskać.

Jeśli strona korzysta z CDN albo usługi pośredniczącej (na przykład Cloudflare), wyczyść też pamięć podręczną w jej panelu. Wyłączanie routera nie pomoże: domowy router nie przechowuje kopii stron.

Czyszczenie pamięci podręcznej WordPress

Jeśli Twoja strona wykorzystuje pamięć podręczną za pomocą jednej z wtyczek tego typu to możesz to zrobić za jej pomocą. Postępowanie w tym celu zwykle jest bardzo podobne.

1. Zaloguj się do panelu administratora WordPressa i przejdź do sekcji „Plugins” (Wtyczki).
2. Znajdź wtyczkę z Cache i kliknij na przycisk „Settings” (Ustawienia).
3. Przejdź do sekcji „Delete Cache” (Usuń pamięć podręczną).
4. Kliknij przycisk „Delete Cache” (Usuń pamięć podręczną).

W tym momencie zmiany powinny zadziałać. Lecz jeśli panel administratora również nie jest dostępny, to możesz wykonać taki zabieg za pomocą FTP.

1. Zaloguj się na serwer FTP za pomocą programu do obsługi FTP, na przykład FileZilla.
2. Przejdź do katalogu głównego WordPressa, który znajduje się najczęściej w katalogu public_html.
3. Znajdź katalog wp-content i otwórz go.
4. Znajdź katalog cache, który zawiera pliki cache, i otwórz go.
5. Znajdź katalog, który odpowiada za dany rodzaj cache, na przykład page-cache lub object-cache.
6. Zaznacz wszystkie pliki w danym katalogu cache i usuń je.
7. Po usunięciu plików cache, przeładuj stronę WordPressa, aby upewnić się, że pamięć podręczna została wyczyszczona.

Błąd 503 na WordPress a plik .htaccess

Plik .htaccess jest plikiem konfiguracyjnym, który znajduje się w katalogu głównym serwera WWW i może być używany do wprowadzenia różnych ustawień dla strony internetowej, takich jak: konfiguracja przekierowań, konfiguracja dostępu do plików, konfiguracja kompresji, konfiguracja cache.

Plik .htaccess powinien być dostsępny w folderze głównym WordPressa. Jego podstawowa zawartość wygląda następująco:

# BEGIN WordPress
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
# END WordPress

Jeśli nie ma w nim takich reguł, to możesz podmienić obecną treść na wyżej wyświetloną i odświeżyć stronę z błędem.

Inną opcją przetestowania pliku .htaccess i jego prawidłowości jest skorzystanie z aplikacji: htaccesscheck.com. Wystarczy, że wrzucisz tam zawartość pliku lub prześlesz cały plik. Narzędzie powinno wyświetlić Ci informacje o zagrożeniach lub błędach.

Błąd 503 na WordPress a limit pamięci PHP

Kolejnym z potencjalnych problemów może być zbyt mały limit pamięci PHP. Dlatego potencjalnym rozwiązaniem jest po prostu jego zwiększenie.

Możesz sprawdzić obecny limit w ustawieniach Twojego serwera lub poprzez prosty skrypt PHP (jednakże niektóre hostingi blokują takie operacje). Dlatego przejdźmy od razu do działań mających na celu zwiększenie tego limitu.

Edycja limitu pamięci PHP przez plik wp-config.php

1. Znajdź plik wp-config.php w katalogu głównym strony WordPress.
2. Otwórz plik wp-config.php w edytorze tekstowym.
3. Dodaj następującą linijkę kodu nad komentarzem „That’s all, stop editing” (dopisana na samym końcu pliku nie zadziała):

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

Ta linijka kodu ustawia limit pamięci na 256 megabajtów. Można ją zmienić na wyższą wartość, w zależności od potrzeb.

Pamiętaj, że WP_MEMORY_LIMIT to prośba WordPressa o więcej pamięci, a nie twarde ustawienie serwera. Według dokumentacji wp-config.php część hostingów blokuje takie podnoszenie limitu. Jeśli po zmianie w logu nadal widzisz komunikat „Allowed memory size of … bytes exhausted”, zmień memory_limit w panelu hostingu (zwykle w ustawieniach wersji PHP) albo poproś o to obsługę.

Edycja limitu pamięci PHP przez plik php.ini

1. Zaloguj się do serwera za pomocą SSH lub FTP.
2. Znajdź plik php.ini na serwerze. Jeśli nie ma takiego pliku, można utworzyć go ręcznie w katalogu głównym serwera WWW.
3. Otwórz plik php.ini w edytorze tekstowym.
4. Znajdź linijkę kodu, która wygląda następująco:

memory_limit = 128M

Ta linijka kodu ustawia limit pamięci na 128 megabajtów. Można ją zmienić na wyższą wartość, na przykład 256M.

Po zmianie wartości zapisz plik i odśwież stronę.

Błąd 503 na WordPress a błędy we wtyczkach lub motywie

Jedną z przyczyn błędu 500 na stronie opartej o WordPress mogą być błędy we wtyczkach lub motywie, które są używane na stronie. Błędnie zaprojektowane lub zakodowane mogą kolidować z innymi wtyczkami, co w ostateczności przekłada się na niedziałanie pewnych funkcji lub właśnie nawet błędy serwera.

Na tym etapie warto sprawdzić, czy wszystkie wtyczki i motywy są zgodne z wersją Twojego WordPressa. Takie informacje powinieneś znaleźć w „szczegółach” każdego motywu i wtyczki.

Jeśli podejrzewasz, że błędy może powodować motyw, to warto zainstalować motyw domyślny jak np.: „Twenty Twenty Two” lub inny twórców WordPress’a, a następnie go włączyć. Pamiętaj jednak, że przed taką operacją warto wykonać kopię zapasową strony i plików.

Jeśli podejrzewasz, że za błąd 500 odpowiada któraś ze wtyczek, to jedynym rozwiązaniem jest wyłączanie wtyczek po kolei i weryfikowanie czy błąd ustąpił.

W przypadku znalezienia wtyczki, która powoduje błąd, możesz skontaktować się z wydawcą wtyczki i zapytać o aktualizacje. Autorzy komercyjnych wtyczek często naprawiają je dość sprawnie, zwłaszcza jeśli jesteś płatnym użytkownikiem.

Błąd 503 na WordPress a pliki rdzenia w folderach wp-admin i wp-includes

W przypadku, gdy na stronie WordPress pojawia się błąd 500, problem może mieć związek z plikami w folderach wp-admin lub wp-includes. Te foldery zawierają kluczowe pliki WordPress, takie jak pliki językowe, style i skrypty, które są wymagane do poprawnego działania strony.

Przed przystąpieniem do jakichkolwiek działań na plikach w tych folderach wykonaj kopię zapasową całej strony. Następnie warto wykonać kilka rzeczy. Jeśli nie korzystasz z najnowszej wersji wordpress’a to możesz pobrać pliki tej konkretnej wersji, z której korzystasz.

Informacja o wersji WordPress’a

Informacje o wersji WordPress’a otrzymasz w kokpicie na pierwszym ekranie (lub po kliknięciu w kokpicie w logo WordPressa, prowadzące do strony about.php)

Możesz też zweryfikować to poprzez odnalezienie w kodzie HTML działającej wersji strony fragment „generator”. W nim powinna być zawarta wersja WordPressa.

Pobranie konkretnej wersji plików WordPress’a

Jeśli masz dostęp do panelu administratora, możesz skorzystać ze wtyczki downgrade, która pobierze za Ciebie odpowiednie pliki i je podmieni.

Możesz też pobrać paczkę plików konkretnej wersji wordpress’a, a następnie przesłać na serwer tylko foldery wp-admin i wp-includes. Następnie odśwież stronę i sprawdź czy błędy zniknęły.

Komunikat „Briefly unavailable for scheduled maintenance” po aktualizacji

To odmiana błędu 503, którą WordPress wywołuje sam. Na czas aktualizacji rdzenia, wtyczek albo motywów tworzy w głównym katalogu strony plik .maintenance i dla każdego odwiedzającego zwraca kod 503 z tym komunikatem. Gdy aktualizacja się dokończy, plik znika. Jeśli przerwiesz aktualizację (zamknięta karta, przekroczony czas na serwerze), plik zostaje.

Co zrobić:

1. Połącz się z serwerem przez FTP albo menedżer plików w panelu hostingu i włącz pokazywanie plików ukrytych (nazwa zaczyna się od kropki).
2. Usuń plik .maintenance z katalogu, w którym leży wp-config.php.
3. Wejdź do Kokpit, Aktualizacje i sprawdź, czy przerwana aktualizacja się dokończyła. Jeśli wtyczka została w połowie wgrana, zainstaluj ją ponownie.

W kodzie WordPressa tryb konserwacji przestaje działać sam po 10 minutach od utworzenia pliku (funkcja wp_is_maintenance_mode), a odpowiedź zawiera nagłówek Retry-After: 600 (wp_maintenance). Jeśli komunikat wisi dłużej, sprawdź, czy strona nie ma własnej wtyczki trybu serwisowego albo cache, który zapisał stronę z błędem. Jak aktualizować bez takich niespodzianek, opisałem w poradniku jak bezpiecznie zaktualizować WordPressa.

Błąd 503 na WordPress a hosting

Błąd 500 na WordPress może być również spowodowany przez problemy z hostingiem. Hosting jest kluczowym elementem dla każdej strony internetowej, a jego wydajność ma bezpośredni wpływ na szybkość i stabilność działania strony.

W takim przypadku niewiele jesteś w stanie zrobić na własną rękę. Dlatego sugeruje skontaktować się z obsługą techniczną hostingu. Najlepiej skorzystać z narzędzi kontaktu natychmiastowego, czyli telefon lub czat.

Zwykle namierzenie problemu przez administratorów hostingu nie trwa zbyt długo. A obsługa tych lepszych hostingów działa przez cały tydzień. Dlatego jeśli żadne z moich rozwiązań Ci nie pomogły to pędź się skontaktować z Twoją firmą hostingową.

Jeśli nie wiesz, gdzie jest hostowana Twoja strona, to możesz to sprawdzić za pomocą narzędzia who.is zwykle tam znajdziesz informacje o rejestratorze domeny oraz o firmie hostingowej.

Jeśli Twoja strona jest utrzymywana przez jakąś agencję lub freelancera, to warto zgłosić im ten problem.

Błąd 503 przy dużym ruchu i limitach hostingu

Jeśli błąd pojawia się falami, na przykład po wysyłce newslettera albo w godzinach szczytu, a w spokojnej porze strona działa, przyczyną jest zwykle brak zasobów: konto hostingowe osiąga limit procesów PHP, pamięci albo CPU i serwer odrzuca kolejne zapytania. W panelu hostingu sprawdź wykres zużycia zasobów z godziny awarii.

Przy analizie ruchu jednego ze sklepów (sierpień 2026, dane z analityki Cloudflare) okazało się, że w szczytowej dobie jeden robot AI odpowiadał za około 95% sumy czasu odpowiedzi serwera, a pamięć podręczna miała tylko 5% trafień, bo strona ustawiała sesję PHP każdemu odwiedzającemu i Cloudflare nie zapisywał takich odpowiedzi. Wniosek, który z tego wyciągam: zanim kupisz większy pakiet, sprawdź, kto obciąża serwer i czy działa pamięć podręczna. Jeśli jednak strona realnie wyrosła z pakietu, kryteria wyboru nowego opisałem w poradniku jaki hosting wybrać dla WordPressa.

Pojedyncze błędy 5xx w raporcie Google Search Console, które nie powtarzają się przy kolejnym sprawdzeniu, to zwykle chwilowy problem. Jeśli wracają co tydzień, to sygnał o serwerze. Google przy błędach 5xx czasowo zwalnia indeksowanie, a adresy, które zwracają błąd długo, z czasem usuwa z indeksu (dokumentacja Google).

Rozwiązywanie problemów z działaniem Twojej strony na WordPress

Jeśli prowadzisz stronę internetową na WordPress i masz problemy z jej działaniem, nie musisz się martwić - jestem tu, aby pomóc!

Dla moich stałych klientów oferuję usługi monitorowania działania strony na WordPress i rozwiązywania wszelkich problemów z nią związanych, w tym błędów 500 oraz innych problemów z hostingiem.

Ponadto, w ramach moich usług oferuję również reprezentowanie przed firmą hostingową, co pozwoli Ci zaoszczędzić czas i nerwy na kontakt z nieznanymi Ci specjalistami. W razie potrzeby skontaktuję się z dostawcą usług hostingowych w Twoim imieniu i zajmę się wszystkimi formalnościami.

Zobacz, jak wygląda stała opieka nad stroną.

Najczęściej zadawane pytania