Biały ekran i błąd 500 w WordPress — diagnostyka krok po kroku

Biały ekran w miejscu strony to jeden z najbardziej frustrujących problemów WordPressa. Otwierasz adres, a tam pusty, biały ekran — żadnego komunikatu, żadnej wskazówki. Równie kłopotliwy jest błąd 500 (Internal Server Error) — serwer odmawia, nie tłumacząc dlaczego. W większości przypadków przyczyna jest jednak dość prosta i da się ją zdiagnozować w kilkanaście minut.

Najczęstsze przyczyny białego ekranu i błędu 500

Zanim zaczniemy naprawę, warto zrozumieć co powoduje te błędy:

1. Konflikt wtyczek (40% przypadków) — nowa lub zaktualizowana wtyczka koliduje z inną
2. Problem z motywem (25%) — błąd w kodzie motywu po aktualizacji
3. Limit pamięci PHP (15%) — WordPress potrzebuje więcej RAM niż serwer przydziela
4. Uszkodzony plik .htaccess (10%) — złe reguły przekierowań
5. Błąd w wp-config.php (5%) — literówka lub brak średnika
6. Problemy z bazą danych (5%) — uszkodzone tabele

Krok 1: Włącz tryb debugowania

Pierwszym krokiem jest zobaczenie co dokładnie poszło nie tak. Biały ekran oznacza, że WordPress ukrywa błędy. Musimy je pokazać.

Połącz się z serwerem przez FTP lub File Manager w panelu hostingu, otwórz wp-config.php i znajdź linijkę:

define('WP_DEBUG', false);

Zamień na:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

To zapisze błędy do pliku wp-content/debug.log bez pokazywania ich użytkownikom. Otwórz ten plik — powinien zawierać konkretny komunikat błędu z nazwą pliku i numerem linii.

Typowe komunikaty:

• Fatal error: Allowed memory size exhausted → problem z pamięcią (krok 3)
• Fatal error: Call to undefined function → konflikt wtyczek (krok 2)
• Parse error: syntax error → błąd w kodzie (sprawdź ostatnio edytowany plik)
• Error establishing a database connection → problem z bazą (krok 6)

Krok 2: Wyłącz wszystkie wtyczki

Jeśli podejrzewasz konflikt wtyczek (najczęstsza przyczyna):

Metoda A: Przez FTP (jeśli nie masz dostępu do panelu)

1. Połącz się przez FTP
2. Przejdź do wp-content/
3. Zmień nazwę folderu plugins na plugins_disabled
4. Odśwież stronę

Jeśli strona działa — problem jest we wtyczce. Teraz:

1. Zmień nazwę z powrotem na plugins
2. Wejdź do folderu plugins
3. Zmieniaj nazwy poszczególnych folderów wtyczek (jedna po drugiej), odświeżając stronę za każdym razem
4. Gdy strona znowu się zepsuje — znalazłeś winowajcę

Metoda B: Przez panel WordPress (jeśli masz dostęp)

1. Wtyczki → Zainstalowane wtyczki
2. Zaznacz wszystkie → Wyłącz
3. Aktywuj po jednej, sprawdzając stronę po każdej aktywacji

Zasada warta wyrobienia: zanim zaktualizujesz wtyczki, zrób kopię zapasową. Możliwość szybkiego przywrócenia oszczędza godziny diagnostyki.

Wtyczki najczęściej powodujące konflikty:

• Wtyczki cache’ujące (W3 Total Cache, WP Super Cache) — konflikty z innymi wtyczkami wydajnościowymi
• Wtyczki bezpieczeństwa (Wordfence, iThemes Security) — zbyt agresywne reguły
• Page buildery (Elementor, WPBakery) — konflikty z motywem
• Wtyczki SEO — dwie aktywne jednocześnie (np. Yoast + Rank Math)

Więcej o wyborze i zarządzaniu wtyczkami przeczytasz w naszym przewodniku po najlepszych wtyczkach WordPress.

Krok 3: Zwiększ limit pamięci PHP

Jeśli w logu widzisz Allowed memory size exhausted:

Metoda 1: wp-config.php

Dodaj przed linią /* That's all, stop editing! */:

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

Metoda 2: .htaccess

Dodaj na początku pliku:

php_value memory_limit 256M

Metoda 3: php.ini

Stwórz plik php.ini w głównym katalogu WordPress:

memory_limit = 256M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M

Jeśli żadna metoda nie działa, Twój hosting może blokować te ustawienia. Skontaktuj się z hostingiem lub rozważ zmianę na lepszy hosting.

Krok 4: Sprawdź motyw

Jeśli wyłączenie wtyczek nie pomogło, problem może być w motywie:

1. Przez FTP przejdź do wp-content/themes/
2. Zmień nazwę folderu aktywnego motywu (np. theme-name → theme-name_disabled)
3. WordPress automatycznie przełączy się na domyślny motyw (Twenty Twenty-Four)
4. Odśwież stronę

Jeśli strona działa z domyślnym motywem — problem jest w Twoim motywie. Sprawdź:

• Czy motyw jest aktualny?
• Czy ostatnio edytowałeś pliki motywu?
• Czy child theme ma poprawny functions.php?

Krok 5: Napraw plik .htaccess

Uszkodzony .htaccess to częsta przyczyna błędu 500:

1. Przez FTP znajdź plik .htaccess w głównym katalogu WordPress
2. Zrób kopię (zmień nazwę na .htaccess_backup)
3. Utwórz nowy .htaccess z domyślną zawartością WordPress:

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

4. Odśwież stronę
5. Jeśli działa — przejdź do Ustawienia → Bezpośrednie odnośniki → Zapisz (wygeneruje nowy .htaccess)

Krok 6: Sprawdź bazę danych

Jeśli widzisz “Error establishing a database connection”:

Sprawdź dane połączenia

Otwórz wp-config.php i sprawdź:

define('DB_NAME', 'nazwa_bazy');
define('DB_USER', 'uzytkownik');
define('DB_PASSWORD', 'haslo');
define('DB_HOST', 'localhost');

Czy te dane są poprawne? Porównaj z ustawieniami w panelu hostingu.

Napraw bazę danych

Dodaj do wp-config.php:

define('WP_ALLOW_REPAIR', true);

Następnie otwórz: https://twojadomena.pl/wp-admin/maint/repair.php

Kliknij “Napraw bazę danych” lub “Napraw i optymalizuj bazę danych”.

Uwaga: po naprawie usuń linijkę WP_ALLOW_REPAIR z wp-config.php. Zostawienie jej to luka bezpieczeństwa — narzędzie naprawcze będzie dostępne bez logowania.

Krok 7: Sprawdź wersję PHP

WordPress 6.x wymaga minimum PHP 7.4, ale zalecana jest PHP 8.1 lub nowsza. Stara wersja PHP może powodować błędy z nowszymi wtyczkami.

Jak sprawdzić wersję PHP:

1. Panel hostingu → sekcja PHP
2. Lub zainstaluj wtyczkę “Display PHP Version”

Jak zmienić:

1. Panel hostingu → Konfiguracja PHP
2. Wybierz PHP 8.1 lub 8.2
3. Zapisz i sprawdź stronę

Przed zmianą wersji PHP sprawdź kompatybilność swoich wtyczek i motywu. Niekompatybilna wtyczka pod PHP 8.x potrafi spowodować kolejny biały ekran — i wracasz do punktu wyjścia.

Krok 8: Sprawdź logi serwera

Jeśli powyższe kroki nie pomogły, sprawdź logi serwera:

• error_log — w głównym katalogu WordPress lub w lokalizacji ustawionej przez hosting
• access_log — może pokazać wzorce ataków lub anomalie
• Panel hostingu → Logi → Error Log

Logi serwera dają najdokładniejszy obraz problemu.

Tabela szybkiej diagnostyki

Jak zapobiegać białym ekranom?

1. Regularne aktualizacje — ale nie na produkcji! Testuj na stagingu.

Dlaczego regularne aktualizacje są kluczowe i jak je robić bezpiecznie.

2. Automatyczne backupy — zawsze miej możliwość szybkiego przywrócenia.

Przeczytaj nasz poradnik backupów WordPress.

3. Staging environment — testuj zmiany na kopii strony, nie na produkcji.

4. Monitoring — automatyczne powiadomienie gdy strona przestaje działać.

5. Profesjonalna opieka — dedykowany specjalista dba o Twoją stronę.

Kiedy wezwać specjalistę?

Jeśli:

• Przeszedłeś wszystkie kroki i problem nadal istnieje
• Nie czujesz się komfortowo edytując pliki przez FTP
• Strona jest krytyczna dla biznesu i nie możesz sobie pozwolić na przestój
• Podejrzewasz atak hakerski (dziwne pliki, przekierowania na obce strony)

Sprawdź, czy Twoja strona wymaga profesjonalnej uwagi — uruchom nasz darmowy audyt WordPress i zobacz raport bezpieczeństwa.

Podsumowanie

Biały ekran i błąd 500 wyglądają groźnie, ale w większości przypadków rozwiązanie jest proste:

1. Włącz debug → przeczytaj komunikat błędu
2. Wyłącz wtyczki → znajdź winowajcę
3. Zwiększ pamięć → jeśli error mówi o memory
4. Zresetuj .htaccess → jeśli błąd 500
5. Sprawdź bazę → jeśli database error

Nie chcesz spędzać godzin na debugowaniu? W ramach pakietów opieki Devance Agency monitorujemy stronę 24/7 i reagujemy na problemy zanim je zauważysz. Czas reakcji od 2 godzin.

Masz problem ze stroną teraz? Napisz do nas — pomożemy naprawić to szybko.