WordPress: 'This site is experiencing technical difficulties' – co to znaczy?

Co oznacza komunikat „This site is experiencing technical difficulties"?

Od wersji WordPress 5.2 istnieje mechanizm zwany fatal error protection. Zamiast pokazywać użytkownikom biały ekran lub techniczny komunikat błędu PHP, WordPress wyświetla przyjazną wiadomość: „This site is experiencing technical difficulties."

Jednocześnie WordPress wysyła na adres e-mail administratora maila z dokładnym opisem błędu i linkiem do specjalnego trybu odzyskiwania. To ogromne ułatwienie w porównaniu z klasycznym WSOD.

Krok 1 – Sprawdź pocztę administratora

WordPress automatycznie wysyła mail na adres podany w Ustawieniach → Ogólne → E-mail administratora. Mail zawiera:

• Nazwę pliku i numer linii gdzie wystąpił błąd
• Rodzaj błędu (np. Fatal error, Parse error, Class not found)
• Unikalny link do trybu odzyskiwania — pozwala zalogować się do panelu WordPress i dezaktywować problematyczną wtyczkę bez naprawiania błędu w kodzie

Kliknij link z maila, zaloguj się i dezaktywuj wskazaną wtyczkę lub motyw. Strona powinna wrócić do działania.

Krok 2 – Jeśli mail nie dotarł

Jeśli hosting blokuje wysyłkę PHP mail() (co jest częste) lub adres administratora jest niepoprawny, mail z linkiem odzyskiwania nie dotrze. W takim przypadku:

Wejdź bezpośrednio w tryb odzyskiwania wpisując w przeglądarce:

https://twojadomena.pl/wp-login.php?action=recovery_mode&rm_token=TOKEN

Token recovery mode jest zapisany w bazie danych w opcji recovery_mode_email. Możesz go odczytać przez phpMyAdmin (tabela wp_options).

Alternatywnie — przez FTP dezaktywuj problematyczną wtyczkę zmieniając nazwę jej folderu w wp-content/plugins/.

Krok 3 – Zdiagnozuj konkretny błąd

Komunikat w mailu mówi Ci co się stało. Najczęstsze typy błędów:

• Fatal error: Class 'NazwaKlasy' not found — wtyczka próbuje użyć funkcji lub klasy z innej wtyczki, która nie jest aktywna lub ma inną wersję. Sprawdź zależności wtyczki.
• Fatal error: Call to undefined function — podobna przyczyna — brakująca funkcja z innej wtyczki lub nieaktualna wersja PHP.
• PHP Fatal error: Allowed memory size exhausted — zwiększ limit pamięci PHP (opisujemy w artykule o WSOD).
• Parse error: syntax error — błąd składni w kodzie PHP, zazwyczaj wynik ręcznej edycji pliku. Cofnij ostatnią zmianę.

Krok 4 – Sprawdź wersję PHP

Częstą przyczyną tego komunikatu po aktualizacji wtyczki jest niekompatybilność z wersją PHP na serwerze. Nowe wersje wtyczek często wymagają PHP 8.0 lub 8.1, podczas gdy hosting może mieć skonfigurowane PHP 7.4.

Sprawdź wymaganą wersję PHP na stronie wtyczki w wordpress.org. Jeśli Twój hosting ma starszą wersję, zmień ją w panelu (cPanel → PHP Selector lub PHP Version). Aktualizacja PHP wymaga ostrożności — sprawdź najpierw kompatybilność całej strony z nową wersją.

Jak zapobiegać temu problemowi?

• Zawsze aktualizuj wtyczki pojedynczo, nie wszystkie naraz
• Sprawdzaj changelog przed aktualizacją — czy nie ma informacji o zmianie wymagań PHP lub zależnościach
• Używaj środowiska staging do testowania aktualizacji przed wdrożeniem na produkcję
• Upewnij się że adres e-mail administratora WordPress jest aktywny i odbiera maile

Ten komunikat to ulepszona wersja białego ekranu WordPress (WSOD) — jeśli widzisz biały ekran zamiast komunikatu „technical difficulties", Twoja instalacja ma starszą wersję WordPressa lub inne ustawienia. Zazwyczaj błąd pojawia się po nieudanej aktualizacji — sprawdź co zrobić gdy aktualizacja zepsuje stronę. Objaw może być też podobny do błędu 500 — warto sprawdzić oba artykuły.