Biały ekran śmierci (WSoD) w wordpressie – jak go naprawić w 5 prostych krokach?

Pewnego dnia, wchodząc na swoją stronę WordPress, zamiast oczekiwanej zawartości, wita Cię przerażający, pusty biały ekran. Brak komunikatów o błędach, brak nawigacji, po prostu nic – oto właśnie spotkał Cię biały ekran śmierci (WSoD). To jedno z najbardziej frustrujących doświadczeń, z jakimi może zmierzyć się właściciel strony WordPress, ponieważ z pozoru nie daje żadnych wskazówek co do przyczyny problemu. WSoD zazwyczaj sygnalizuje krytyczny błąd PHP, który zatrzymuje wykonanie kodu, uniemożliwiając załadowanie jakiejkolwiek treści. Może być spowodowany przez szereg czynników, takich jak niezgodność wtyczek lub motywów, wyczerpanie limitu pamięci PHP, uszkodzone pliki WordPressa, a nawet problemy z serwerem. Ale nie panikuj! Jako doświadczony ekspert SEO, wiem, że większość przypadków WSoD można szybko zdiagnozować i naprawić. W tym artykule przeprowadzimy Cię przez pięć prostych, krok po kroku, metod rozwiązywania tego problemu, przywracając Twoją stronę do życia.

Diagnoza podstawą sukcesu: włącz tryb debugowania wordpressa

Pierwszym i najważniejszym krokiem w walce z białym ekranem śmierci jest ujawnienie prawdziwej przyczyny problemu. WSoD jest irytujący, ponieważ ukrywa komunikaty o błędach. Aby to zmienić, musimy aktywować tryb debugowania WordPressa. Pozwoli to wyświetlić konkretne błędy, które zatrzymują działanie Twojej strony, dając nam cenne wskazówki do dalszych działań.

Aby włączyć debugowanie, będziesz potrzebować dostępu do plików swojej strony za pośrednictwem klienta FTP (np. FileZilla) lub menedżera plików w panelu kontrolnym Twojego hostingu. Po połączeniu się, przejdź do katalogu głównego WordPressa i znajdź plik o nazwie wp-config.php. Zawsze wykonaj kopię zapasową tego pliku przed wprowadzeniem jakichkolwiek zmian! Otwórz plik i znajdź linię:

define('WP_DEBUG', false);

Zmień wartość false na true:

define('WP_DEBUG', true);

Dla jeszcze lepszej diagnostyki, szczególnie jeśli WSoD nadal uniemożliwia wyświetlanie błędów na ekranie, możesz dodać poniższą linię tuż pod zmienioną wartością WP_DEBUG:

define('WP_DEBUG_LOG', true);

Ta linia spowoduje zapisywanie wszystkich błędów do pliku debug.log, który znajdziesz w katalogu wp-content. Po zapisaniu zmian i ponownym załadowaniu strony, biały ekran może zostać zastąpiony konkretnym komunikatem o błędzie, wskazującym na plik i linię kodu, które są źródłem problemu. Może to być wtyczka, motyw lub plik rdzenny WordPressa. Zanotuj ten błąd i wyłącz debugowanie, gdy skończysz, aby nie ujawniać potencjalnych luk bezpieczeństwa ani nie spowalniać strony produkcyjnej.

Podejrzany numer jeden: problematyczne wtyczki

Jeśli tryb debugowania wskazał na problem z wtyczką lub jeśli po włączeniu debugowania nadal widzisz biały ekran (co oznacza, że błąd jest tak krytyczny, że nawet debugowanie nie może się uruchomić), najczęściej problemem są niezgodne lub źle zakodowane wtyczki. Zbyt wiele wtyczek, ich aktualizacje, a nawet konflikty między nimi mogą prowadzić do WSoD.

Aby zdiagnozować, czy wtyczka jest winowajcą, musisz je wszystkie dezaktywować. Ponieważ dostęp do panelu administracyjnego jest prawdopodobnie niemożliwy, zrobimy to poprzez FTP lub menedżera plików. Przejdź do katalogu wp-content, a następnie znajdź folder o nazwie plugins. Zmień jego nazwę na przykład na plugins_old.

Po zmianie nazwy folderu, WordPress nie będzie w stanie odnaleźć żadnych wtyczek, co spowoduje ich automatyczną dezaktywację. Teraz spróbuj załadować swoją stronę. Jeśli strona działa poprawnie i biały ekran zniknął, to z pewnością problemem jest jedna z Twoich wtyczek.

Aby zidentyfikować konkretną wtyczkę, zmień nazwę folderu plugins_old z powrotem na plugins. Następnie, zaloguj się do panelu administracyjnego WordPressa (jeśli teraz jest to możliwe) i dezaktywuj wszystkie wtyczki z poziomu panelu. Po dezaktywacji wszystkich, aktywuj je pojedynczo, odświeżając stronę po każdej aktywacji, aż do momentu ponownego pojawienia się białego ekranu. Wtyczka, po której aktywacji pojawił się WSoD, jest winowajcą. Usuń ją lub znajdź dla niej alternatywę, a następnie skontaktuj się z jej twórcą.

Potencjalny winowajca: wadliwy motyw

Jeśli dezaktywacja wszystkich wtyczek nie rozwiązała problemu WSoD, kolejnym najbardziej prawdopodobnym winowajcą jest motyw Twojej strony. Podobnie jak wtyczki, źle zakodowany motyw, niezgodność z nową wersją WordPressa, czy nawet uszkodzone pliki motywu mogą prowadzić do krytycznych błędów PHP i białego ekranu.

Proces diagnozy jest zbliżony do tego z wtyczkami – musimy zmusić WordPressa do użycia domyślnego, zazwyczaj stabilnego motywu. Ponownie, będziesz potrzebować dostępu FTP lub menedżera plików. Przejdź do katalogu wp-content/themes. Znajdziesz tam foldery dla wszystkich zainstalowanych motywów, w tym Twój aktualnie używany motyw oraz domyślne motywy WordPressa (np. Twenty Twenty-Four, Twenty Twenty-Three itp.).

Zmień nazwę folderu Twojego aktywnego motywu (tego, który powodował problem) na coś innego, na przykład nazwa_motywu_old. Kiedy WordPress nie będzie mógł znaleźć aktywnego motywu, automatycznie powróci do jednego z domyślnych motywów, jeśli są zainstalowane (co jest standardem w świeżej instalacji). Jeśli nie masz żadnych domyślnych motywów, możesz pobrać najnowszą wersję z oficjalnej strony WordPress.org i umieścić ją w folderze wp-content/themes.

Po zmianie nazwy folderu motywu, spróbuj odświeżyć swoją stronę. Jeśli strona załaduje się poprawnie (choć z innym wyglądem), to potwierdza, że problemem był Twój motyw. W takim przypadku masz kilka opcji: skontaktuj się z twórcą motywu, poszukaj jego aktualizacji, spróbuj zainstalować go ponownie, lub rozważ zmianę na inny, bardziej stabilny motyw. Pamiętaj, aby po wszystkim przywrócić poprawną nazwę folderu dla testowanego motywu, jeśli zdecydujesz się na jego naprawę.

Zwiększanie limitu pamięci php: często pomijana kwestia

Jeśli dezaktywacja wtyczek i zmiana motywu nie rozwiązały problemu WSoD, a tryb debugowania wskazuje na błędy związane z wyczerpaniem pamięci (np. „Allowed memory size of xxx bytes exhausted”), prawdopodobnie Twoja instalacja WordPressa przekroczyła domyślny limit pamięci PHP ustawiony na serwerze. WordPress i wiele wtyczek oraz motywów wymagają znacznych zasobów pamięci, a domyślne ustawienia hostingu mogą być niewystarczające, szczególnie dla rozbudowanych stron.

Najprostszym sposobem na zwiększenie limitu pamięci jest edycja pliku wp-config.php, który już znamy. Otwórz go ponownie za pomocą klienta FTP lub menedżera plików i dodaj następującą linię kodu przed linią /* That's all, stop editing! Happy publishing. */:

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

Ta linia zwiększy limit pamięci WordPressa do 256 megabajtów. W większości przypadków jest to wystarczająca ilość, aby uniknąć problemów z wyczerpaniem pamięci. Możesz również spróbować wartości 128M lub 512M, w zależności od potrzeb Twojej strony i możliwości serwera.

Jeśli dodanie tej linii nie przyniesie efektu, może to oznaczać, że Twój hosting ma nałożone niższe limity pamięci na poziomie serwera, które nadpisują ustawienia w wp-config.php. W takiej sytuacji będziesz musiał skontaktować się ze swoim dostawcą hostingu i poprosić o zwiększenie limitu pamięci PHP dla Twojej domeny. Alternatywne metody to edycja pliku php.ini (jeśli masz do niego dostęp) lub dodanie dyrektywy do pliku .htaccess, jednak są one bardziej skomplikowane i zależą od konfiguracji serwera.

Sprawdzenie plików rdzennych wordpressa i uprawnień

Jeśli wszystkie poprzednie kroki zawiodły, a biały ekran śmierci nadal straszy, problem może leżeć w uszkodzonych plikach rdzennych WordPressa lub nieprawidłowych uprawnieniach do plików i katalogów. Uszkodzenie plików może nastąpić podczas nieudanej aktualizacji, ataku hakerskiego lub problemów z serwerem. Niepoprawne uprawnienia mogą uniemożliwiać WordPressowi dostęp do niezbędnych plików.

Aby naprawić uszkodzone pliki rdzenne, będziesz musiał ręcznie zastąpić je świeżymi wersjami. Zacznij od pobrania najnowszej wersji WordPressa z oficjalnej strony wordpress.org. Rozpakuj archiwum na swoim komputerze. Następnie, za pomocą klienta FTP lub menedżera plików, połącz się ze swoją stroną. Skopiuj i zastąp katalogi wp-admin i wp-includes z pobranej paczki WordPressa do katalogu głównego Twojej strony. Pamiętaj, aby nie kopiować folderu wp-content, ponieważ zawiera on Twoje motywy, wtyczki i pliki multimedialne.

Po zastąpieniu plików rdzennych, sprawdź uprawnienia do plików i katalogów. Nieprawidłowe uprawnienia są częstą przyczyną problemów. Ogólna zasada mówi, że katalogi powinny mieć uprawnienia 755, a pliki 644. Możesz to sprawdzić i zmienić za pomocą klienta FTP (klikając prawym przyciskiem myszy na pliku/katalogu i wybierając „Uprawnienia pliku” lub „File permissions”).

Oto tabela z typowymi uprawnieniami:

Typ elementu	Zalecane uprawnienia	Opis
Katalogi	755	Właściciel ma pełny dostęp (odczyt, zapis, wykonanie), grupa i inni mają dostęp do odczytu i wykonania.
Pliki	644	Właściciel ma dostęp do odczytu i zapisu, grupa i inni mają tylko dostęp do odczytu.
Plik wp-config.php	640 lub 600	Bardziej restrykcyjne uprawnienia dla tego kluczowego pliku konfiguracyjnego dla zwiększenia bezpieczeństwa.

Po zakończeniu wszystkich tych kroków, spróbuj ponownie załadować swoją stronę. Jeśli problem nadal występuje, skontaktuj się z dostawcą hostingu, ponieważ problem może leżeć po stronie serwera (np. wyczerpanie zasobów, błąd w konfiguracji serwera).

Zakończenie

Biały ekran śmierci (WSoD) w WordPressie, choć na pierwszy rzut oka może wydawać się koszmarem każdego właściciela strony, jest problemem, który w większości przypadków można rozwiązać dzięki systematycznemu podejściu. Przeszliśmy przez pięć kluczowych kroków diagnostycznych i naprawczych, które pozwalają zidentyfikować i usunąć najczęstsze przyczyny tego frustrującego błędu. Rozpoczęliśmy od włączenia trybu debugowania, który jest niczym latarka w ciemności, ujawniająca ukryte błędy. Następnie skupiliśmy się na diagnostyce wtyczek, często będących źródłem konfliktu, poprzez ich masową dezaktywację. Kolejnym krokiem była weryfikacja motywu, który również może powodować WSoD. Poruszyliśmy również kwestię zwiększenia limitu pamięci PHP, co jest kluczowe dla stron o dużym zapotrzebowaniu na zasoby. Na koniec, omówiliśmy sprawdzenie i zastąpienie plików rdzennych WordPressa oraz poprawne ustawienie uprawnień, co stanowi ostatnią linię obrony przed uporczywymi błędami.

Pamiętaj, że kluczem do sukcesu jest cierpliwość i dokładność. Każdy z tych kroków powinien być wykonywany pojedynczo, z weryfikacją efektów po każdej zmianie. Niezwykle ważne jest również regularne tworzenie kopii zapasowych całej strony WordPress – zarówno plików, jak i bazy danych. To Twoja polisa ubezpieczeniowa na wypadek wszelkich problemów, w tym WSoD. Jeśli po wykonaniu wszystkich tych kroków problem nadal występuje, nie wahaj się skontaktować z pomocą techniczną swojego dostawcy hostingu; ich specjaliści mają dostęp do bardziej szczegółowych logów serwera i mogą pomóc w diagnozie. Z odrobiną wiedzy i tych prostych wskazówek, WSoD przestanie być Twoim wrogiem, a stanie się tylko kolejnym, łatwym do pokonania wyzwaniem.

Grafika:Miguel Á. Padriñán
https://www.pexels.com/@padrinan