Jak naprawić pustą białą stronę WordPress – White Screen of Death

Jeśli otwierasz swoją witrynę WordPress i widzisz pustą białą stronę, oznacza to, że WordPress zwraca błąd krytyczny, technicznie znany jako błąd 500 lub white screen of death.

Ten błąd powodują głównie wadliwe pluginy lub motywy. Aby zlokalizować źródło błędu, możesz aktywować tryb debug WordPress, edytując dwie linie w pliku wp-config.php twojej instalacji WordPress.

Szczęśliwy deweloper po naprawieniu błędu pustej białej strony w WordPress.

Włącz tryb debug, aby naprawić pustą białą stronę WordPress

Zaloguj się do cPanel lub FTP

  • Użyj swoich danych logowania cPanel, aby zalogować się lub połączyć z witryną przez klienta FTP, np. FileZilla.

Edytuj plik wp-config.php.

  • W menedżerze plików cPanel lub kliencie FTP przejdź do katalogu głównego WordPress i znajdź plik wp-config.php.
  • Edytuj plik wp-config.php, dodając lub modyfikując poniższe linie:
PHP
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
  • Zapisz zmiany w wp-config.php.

Przeładuj witrynę.

  • Po przeładowaniu witryny wszystkie błędy będą logowane w pliku wp-content/debug.log.
  • Jeśli wolisz widzieć błędy bezpośrednio na ekranie zamiast w logu, zmień linię na:
PHP
define('WP_DEBUG_DISPLAY', true);

Przeanalizuj debug.log.

  • Załaduj witrynę WordPress ponownie. Konkretny błąd powinien być zalogowany w pliku debug.log lub wyświetlony na ekranie, w zależności od ustawienia.
  • Otwórz plik debug.log za pomocą pluginu menedżera plików lub FTP i poszukaj linii zawierających „Fatal Error…”. Te linie zazwyczaj wskażą plugin lub motyw powodujący błąd.

Wyłącz plugin powodujący pustą białą stronę

  1. Zidentyfikuj wadliwy plugin.
    • Po zidentyfikowaniu wadliwego pluginu z debug.log zaloguj się na serwer przez FTP lub cPanel.
  2. Zmień nazwę folderu pluginu.
    • Przejdź do katalogu wp-content/plugins/.
    • Zmień nazwę problematycznego folderu pluginu na inną, np. wp-content/plugins/yoast_bak.
    • To dezaktywuje plugin. Przeładuj witrynę, a biały ekran powinien zniknąć.
  3. Interpretacja logu debugowania.
    • Załóżmy, że masz trudność z interpretacją wpisów w pliku logu debugowania. W takim wypadku możesz otworzyć zgłoszenie do swojego dostawcy Hostingu lub skontaktować się z profesjonalistą WordPress, przekazując mu plik logu do analizy.
  4. Sprawdź brakujący plik debug.log.
    • Jeśli plik debug.log WordPress nie jest tworzony, upewnij się, że plik wp-config.php jest prawidłowo zedytowany, a serwer ma odpowiednie uprawnienia do zapisu w katalogu wp-content. Więcej szczegółów w tym artykule: Jak naprawić WordPress nie tworzący pliku debug.log.

Dodatkowe wskazówki:

  • Sprawdź kompatybilność motywu: Czasami motywy też mogą powodować white screen of death. Aby sprawdzić, czy problemem jest motyw, tymczasowo przełącz na domyślny motyw WordPress, np. Twenty Twenty-One.
  • Zwiększ limit pamięci PHP: Niski limit pamięci PHP może powodować pustą białą stronę. Aby go zwiększyć, dodaj poniższą linię do pliku wp-config.php:
PHP
define('WP_MEMORY_LIMIT', '128M');
  • Wyczyść cache: Jeśli używasz pluginu cache, wyczyść cache. Czasami zcache’owane pliki mogą powodować problemy z wyświetlaniem.
  • Zaktualizuj rdzeń WordPress, pluginy i motywy: Upewnij się, że twoja instalacja WordPress, pluginy i motywy są aktualne, aby uniknąć problemów z kompatybilnością.

Stosując te kroki, powinieneś być w stanie sprawnie zdiagnozować i naprawić błąd pustej białej strony WordPress.

Jeśli masz trudność z interpretacją wpisów w pliku logu debugowania, możesz otworzyć zgłoszenie wsparcia i przesłać nam plik logu.

Updated on 23 maja, 2026

Rene Hermenau

Autor: Rene Hermenau

About the author: René Hermenau is the founder of WP STAGING. He works on WordPress backups, staging, migrations, database handling, and safe deployment workflows.