Błąd 500 w WordPressie: jak go naprawić krok po kroku
Błąd 500 w WordPressie, znany jako „internal server error”, należy do najczęściej spotykanych problemów właścicieli stron internetowych. Może pojawić się w dowolnym momencie i zablokować dostęp do witryny zarówno dla użytkowników, jak i administratora. Komunikat „błąd HTTP 500” nie podaje bezpośredniej przyczyny awarii. Z tego poradnika dowiesz się, jak naprawić błąd serwera 500 WordPress szybko i bezpiecznie, bez konieczności posiadania zaawansowanych umiejętności technicznych. Poradnik oparty jest na praktycznych etapach diagnostyki, od najprostszych metod wzwyż. Wskazówki przygotowano, mając na uwadze polskie realia hostingu i najczęściej używane narzędzia przez właścicieli małych oraz średnich firm.
Czym jest błąd 500 w WordPressie?
Błąd 500 w WordPressie to ogólny komunikat o problemie po stronie serwera. Oznacza, że serwer nie jest w stanie przetworzyć żądania, ale nie podaje szczegółowej przyczyny. Błąd 500 nie wskazuje źródła awarii, w przeciwieństwie do błędów takich jak 404. Najczęstsze powody to błąd jednego z plików, problematyczna wtyczka lub motyw, uszkodzony plik.htaccess, niski limit pamięci PHP lub niekompatybilna wersja PHP na hostingu.
Jeżeli Twoja strona wyświetla „internal server error WordPress” lub nie otwiera się wcale, zobacz tabelę poniżej. Znajdziesz tam najczęstsze przyczyny tego błędu i sugerowaną kolejność sprawdzania.
| Potencjalna przyczyna błędu 500 | Czy możesz naprawić samodzielnie? | Poziom trudności |
|---|---|---|
| Błąd wtyczki lub motywu | Tak | Niski |
| Uszkodzony plik.htaccess | Tak | Niski |
| Zbyt niski limit pamięci PHP | Tak | Średni |
| Nieodpowiednia wersja PHP | Tak | Średni |
| Błąd w plikach systemowych WordPressa | Częściowo | Średni/Wysoki |
| Problem z hostingiem | Nie | Wysoki (kontakt z pomocą techniczną) |
Proces krok po kroku: naprawa błędu 500 w WordPressie
- Stwórz kopię zapasową strony i bazy danych.
- Włącz tryb debugowania WordPress (WP_DEBUG).
- Sprawdź logi błędów (debug.log, error log serwera).
- Wyłącz wszystkie wtyczki przez FTP lub menedżer plików.
- Przełącz motyw na domyślny (np. Twenty Twenty-Three).
- Regeneruj plik.htaccess.
- Zwiększ limit pamięci PHP.
- Sprawdź wersję PHP na hostingu.
- Sprawdź uprawnienia plików i katalogów.
- Gdy to nie pomoże: skontaktuj się z pomocą hostingu.
Szczegóły dotyczące każdego kroku znajdziesz poniżej.
Włącz debugowanie WordPress (WP_DEBUG) i sprawdź logi
Rozpocznij diagnostykę od aktywowania trybu debugowania w WordPressie. Ta funkcja umożliwia wyświetlenie konkretnych błędów zamiast ogólnego komunikatu HTTP 500. Do jej włączenia edytujesz plik wp-config.php znajdujący się w głównym katalogu strony (dostęp przez FTP lub menedżer plików hostingu).
- Zaloguj się do FTP lub skorzystaj z menedżera plików w panelu hostingu.
- Otwórz plik
wp-config.php. - Znajdź linię:
define('WP_DEBUG', false);. - Zmień ją na:
define('WP_DEBUG', true); - Dodaj poniżej:
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Po zapisaniu pliku odwiedź ponownie stronę. Wygenerowane błędy znajdują się teraz w wp-content/debug.log. Przejrzyj komunikaty, często zawierają wskazanie na określoną wtyczkę, motyw lub plik powodujący błąd 500.
Panel hostingu pozwala także na dostęp do logów błędów serwera. Zazwyczaj opcja ta jest dostępna w sekcjach „Logi” lub „Błędy” w panelach takich jak DirectAdmin czy cPanel. Znajdziesz tam dodatkowe informacje o źródle błędu HTTP 500.
Wyłącz wszystkie wtyczki przez FTP lub panel plików
Najczęstsza przyczyna błędu „WordPress error 500” to wadliwa lub niekompatybilna wtyczka. Jeżeli nie masz dostępu do Kokpitu WordPressa, dezaktywuj wszystkie wtyczki ręcznie:
- Przez FTP lub menedżer plików przejdź do katalogu
wp-content. - Zmień nazwę folderu
plugins(np. naplugins-off). - Odwiedź stronę i sprawdź, czy działa. Jeśli wraca do normy, problem leży po stronie którejś wtyczki.
Aby zidentyfikować, która wtyczka powoduje błąd:
- Przywróć nazwę folderu na
plugins. - Wejdź do środka i kolejno zmieniaj nazwę każdego podfolderu wtyczki na
nazwa-off, odświeżając stronę po każdej zmianie.
Wadliwa wtyczka może zablokować stronę mimo wcześniejszego poprawnego działania. Aktualizacje WordPressa i dodatków nie zawsze są kompatybilne.
Przełącz motyw na domyślny
Jeżeli problem nadal występuje lub debug.log wskazuje na motyw, zmień go na domyślny (np. Twenty Twenty-Three). Jak to zrobić?
- Znajdź katalog
wp-content/themes. - Zmień nazwę folderu aktywnego motywu (np.
mojmotywnamojmotyw-old). - WordPress automatycznie przełączy się na pierwszy dostępny motyw domyślny.
Sprawdź plik.htaccess i przywróć jego domyślną wersję
Uszkodzenie pliku.htaccess może spowodować natychmiastową niedostępność strony. Plik konfiguracyjny apacza, często edytowany przez wtyczki lub narzędzia SEO, odpowiada za kluczowe ustawienia.
- Przez FTP lub menedżer plików odnajdź plik
.htaccessw głównym katalogu WordPress. - Pobierz go na komputer (na wypadek potrzeby przywrócenia), po czym usuń z serwera lub zmień nazwę (
.htaccess-old). - Odwiedź stronę i zobacz, czy działa. Wtedy możesz mieć pewność, że problem był w.htaccess.
- Aby wygenerować nowy, domyślny plik, zaloguj się do panelu WordPress (jeśli strona już działa), przejdź do „Ustawienia → Bezpośrednie odnośniki” i kliknij „Zapisz zmiany”. Nowy plik utworzy się automatycznie.
Zwiększ limit pamięci PHP dla WordPressa
WordPress i dodatki wymagają pewnej ilości pamięci RAM. Gdy zasoby są niewystarczające, serwer zgłasza błąd HTTP 500. Da się zwiększyć limit edytując wp-config.php:
- Dodaj poniższą linię (przed „That’s all, stop editing!”):
define('WP_MEMORY_LIMIT', '256M');
Podniesienie limitu często rozwiązuje problem.
Można też zmienić ten parametr w panelu hostingu (np. DirectAdmin → Ustawienia PHP).
Zmień lub sprawdź wersję PHP na hostingu
Niekompatybilność wersji PHP może skutkować błędami serwera 500. W panelu większości polskich hostingów możesz zmienić wersję PHP dla wybranej domeny lub katalogu.
- Wejdź do ustawień PHP lub sekcji konfiguracji PHP.
- Wybierz wersję rekomendowaną przez WordPress: przykładowo 7.4, 8.0 lub wyższą, jeśli motyw i wtyczki są z nimi zgodne.
- Po zapisaniu zmian sprawdź, czy strona działa.
Sprawdź uprawnienia plików i katalogów
Złe uprawnienia blokują serwerowi dostęp do części plików i prowadzą do błędu 500. Najczęściej występujące wartości to:
- Katalogi: 755
- Pliki: 644
Uprawnienia sprawdzisz i zmienisz przez menedżera plików lub klienta FTP (np. FileZilla).
Co zrobić, gdy powyższe kroki nie pomagają?
Jeśli po wdrożeniu wszystkich opisanych działań błąd 500 WordPressa utrzymuje się, przyczyna może leżeć po stronie hostingu lub konfiguracji serwera. W takiej sytuacji przygotuj jak najwięcej informacji (np. fragmenty logów, listę podjętych działań) i skontaktuj się z supportem swojego usługodawcy. Podaj szczegóły z plików debug.log i error log.
Ilustracje w tym artykule zostały wygenerowane przy użyciu narzędzi AI.
Porównanie narzędzi i metod naprawy błędu 500
| Narzędzie / Metoda | Gdzie zastosować? | Zalety | Wady |
|---|---|---|---|
| FTP / Menedżer plików | Wtyczki, motywy,.htaccess, uprawnienia | Daje dostęp bez panelu WordPress, pełna kontrola | Możliwość przypadkowego usunięcia plików |
| Panel hostingu | Zmiana PHP, limit pamięci, logi | Wiele rzeczy ustawiasz od razu | Trzeba znać panel lub znaleźć odpowiednią opcję |
| Kokpit WordPress | Odnowienie.htaccess, motywy i wtyczki (jeśli dostępny) | Szybkość obsługi | Niedostępny przy błędzie 500 |
Lista kontrolna
- Backup przed każdą zmianą
- Debugowanie aktywne w wp-config.php
- Analiza pliku debug.log lub error log serwera
- Dezaktywacja wszystkich wtyczek przez FTP/menedżer plików
- Zmiana motywu na domyślny w razie potrzeby
- Rekonstrukcja pliku.htaccess
- Zwiększenie limitu pamięci PHP
- Sprawdzenie wersji PHP i kompatybilności
- Weryfikacja uprawnień plików
- Kontakt z supportem hostingu, jeśli brak efektów
Najczęściej zadawane pytania
Co oznacza błąd 500 w WordPressie?
Błąd 500 oznacza, że serwer napotkał problem i nie przetworzył zapytania. Nie precyzuje powodu. Często przyczyną jest wtyczka, motyw, uszkodzony plik lub nietrafiona konfiguracja.
Jak wyłączyć wtyczki WordPress bez dostępu do Kokpitu?
Przez FTP lub menedżera plików zmień nazwę folderu plugins (np. na plugins-off). Wszystkie dodatki zostają wtedy automatycznie wyłączone.
Skąd wziąć logi błędów WordPress lub serwera?
Po włączeniu WP_DEBUG logi znajdują się w wp-content/debug.log. Logi serwera dostępne są w panelu hostingu, w sekcji „Logi” lub „Błędy”.
Jak naprawić uszkodzony plik.htaccess?
Usuń lub zmień nazwę istniejącego pliku.htaccess. Następnie zaloguj się do Kokpitu WordPress i zapisz ustawienia „Bezpośrednich odnośników”. System wygeneruje nowy plik.htaccess.
Kiedy poprosić o pomoc support hostingu?
Jeśli wdrożyłeś opisane wyżej działania i błąd 500 nadal się pojawia, support hostingu ma do dyspozycji narzędzia diagnostyczne i logi, niedostępne samodzielnemu użytkownikowi oraz może wskazać źródło problemu po stronie serwera.
Podsumowanie
Błąd 500 w WordPressie wymaga spokojnej i stopniowej diagnostyki. Najlepiej eliminować problem, podchodząc etapami: backup, debugowanie, testowanie wtyczek i motywów, korekta.htaccess, zwiększenie limitu pamięci oraz kontrola wersji PHP. Te kroki pozwalają zawęzić źródło błędu i przywrócić stronę do działania, nawet bez pomocy programisty.
Ostatnie etapy mogą wymagać interwencji specjalisty. W razie wątpliwości, sięgnij do dokumentacji WordPressa, np. Debugging in WordPress lub przetestuj opisane narzędzia i poradniki w naszych kategoriach: WordPress oraz automatyzacja biznesu.