Rozwiązywanie typowych błędów WordPress

Cel Artykułu: Poznasz najczęściej występujące problemy z WordPressem oraz dowiesz się, jak skutecznie je diagnozować i rozwiązywać. Artykuł pomoże Ci szybko przywrócić działanie Twojej strony WordPress w przypadku typowych awarii.

WordPress jest najpopularniejszym systemem zarządzania treścią (CMS), ale czasem mogą pojawić się problemy z jego działaniem. W tym artykule przedstawiamy najczęstsze błędy WordPress i sprawdzone metody ich rozwiązywania.

Biały ekran śmierci (White Screen of Death - WSOD)

Biały ekran śmierci to problem, w którym zamiast witryny widzisz jedynie pustą, białą stronę, bez komunikatów o błędach.

Przyczyny WSOD:

  • Wyczerpany limit pamięci PHP
  • Problemy z wtyczkami
  • Konflikty z motywem
  • Błędy w plikach funkcyjnych (np. functions.php)

Rozwiązanie:

  1. Włącz debugowanie WordPress: Dodaj następujące linie do pliku wp-config.php:

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

    Te ustawienia spowodują zapisywanie błędów do pliku debug.log w katalogu wp-content.

  2. Zwiększ limit pamięci PHP: Dodaj następującą linię do pliku wp-config.php:

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

  3. Deaktywuj wszystkie wtyczki:

    • Jeśli masz dostęp do panelu administracyjnego, przejdź do sekcji "Wtyczki" i deaktywuj wszystkie.
    • Jeśli nie masz dostępu do panelu, zmień nazwę katalogu plugins w folderze wp-content (np. na plugins_old) używając klienta FTP/SFTP.

  4. Przełącz motyw na domyślny:

    • W panelu WordPress: Wygląd > Motywy > aktywuj Twenty Twenty-Five
    • Przez FTP/SFTP: Przejdź do katalogu wp-content/themes i zmień nazwę folderu aktualnego motywu.

Błąd 500 (Internal Server Error)

Błąd 500 oznacza wewnętrzny problem z serwerem i może mieć wiele potencjalnych przyczyn.

Przyczyny błędu 500:

  • Uszkodzony plik .htaccess
  • Niekompatybilna wtyczka
  • Wyczerpany limit zasobów serwera
  • Nieprawidłowe uprawnienia plików

Rozwiązanie:

  1. Sprawdź plik .htaccess:

    • Uzyskaj dostęp do głównego katalogu WordPress przez FTP/SFTP
    • Zmień nazwę pliku .htaccess na .htaccess_old
    • Przejdź do panelu administracyjnego WordPress > Ustawienia > Bezpośrednie Odnośniki, aby wygenerować nowy plik .htaccess

  2. Sprawdź uprawnienia plików: Uprawnienia powinny być ustawione następująco:

    • Katalogi: 755 (drwxr-xr-x)
    • Pliki: 644 (rw-r--r--)
    • wp-config.php: 600 (rw-------)

  3. Sprawdź logi serwera:

    • Logi błędów PHP mogą znajdować się w katalogu /var/log/php-errors na Twoim koncie hostingowym
    • W DirectAdmin możesz również sprawdzić logi w sekcji "Site Summary" > "Error Logs"

Błąd "Ustanowienie połączenia z bazą danych" (Error Establishing a Database Connection)

Ten błąd pojawia się, gdy WordPress nie może połączyć się z bazą danych MySQL.

Przyczyny:

  • Nieprawidłowe dane dostępowe do bazy danych w pliku wp-config.php
  • Przeciążenie serwera bazy danych
  • Uszkodzona baza danych
  • Przekroczenie limitów połączeń

Rozwiązanie:

  1. Sprawdź dane dostępowe do bazy danych:

    • Otwórz plik wp-config.php
    • Sprawdź poprawność poniższych ustawień:
      define('DB_NAME', 'nazwa_bazy_danych');
define('DB_USER', 'użytkownik_bazy');
define('DB_PASSWORD', 'hasło_do_bazy');
define('DB_HOST', 'localhost');

  2. Napraw bazę danych:

    • Dodaj poniższą linię do pliku wp-config.php:
      define('WP_ALLOW_REPAIR', true);
    • Odwiedź adres: https://twoja-domena.pl/wp-admin/maint/repair.php
    • Po zakończeniu naprawy, usuń linię WP_ALLOW_REPAIR z pliku konfiguracyjnego

  3. Sprawdź użycie zasobów w DirectAdmin:

    • Zaloguj się do panelu DirectAdmin przez Panel Klienta
    • Przejdź do sekcji "Site Summary" > "Resource Usage"
    • Sprawdź, czy nie przekraczasz limitów połączeń do bazy danych dla Twojego pakietu

Komunikat "Briefly unavailable for scheduled maintenance"

Ten komunikat pojawia się podczas aktualizacji WordPress, ale może "zawisnąć" i pozostać nawet po zakończeniu aktualizacji.

Rozwiązanie:

  • Połącz się z Twoim serwerem przez SFTP/FTP
  • Sprawdź główny katalog WordPress
  • Usuń plik o nazwie .maintenance

Błąd przy przesyłaniu obrazków lub mediów

Problemy z wgrywaniem plików do biblioteki mediów to częsty problem w WordPress.

Przyczyny:

  • Niewystarczające uprawnienia katalogu uploads
  • Zbyt mały limit rozmiaru przesyłanych plików
  • Niedostateczny limit czasu wykonywania skryptu

Rozwiązanie:

  1. Sprawdź uprawnienia katalogu uploads:

    • Katalog wp-content/uploads powinien mieć uprawnienia 755
    • Możesz zmienić uprawnienia przez FTP/SFTP lub polecenie:
      chmod -R 755 wp-content/uploads

  2. Zwiększ limity w DirectAdmin:

    • Zaloguj się do panelu DirectAdmin przez Panel Klienta
    • Przejdź do "Wybór wersji PHP dla domeny"
    • Znajdź sekcję z limitami PHP i zwiększ upload_max_filesize oraz post_max_size

  3. Alternatywna metoda przesyłania plików:

    • Prześlij pliki mediów bezpośrednio na serwer przez FTP/SFTP do katalogu wp-content/uploads
    • Następnie użyj wtyczki "Add From Server" aby dodać je do biblioteki mediów WordPress

Przekierowania po zalogowaniu / zapętlone przekierowanie

Czasami po zalogowaniu do panelu WordPress, przeglądarka wyświetla błąd o zbyt wielu przekierowaniach.

Przyczyny:

  • Konflikt z wtyczkami zabezpieczającymi
  • Nieprawidłowa konfiguracja adresów URL w WordPress
  • Problemy z plikami cookie
  • Konflikt z cache strony

Rozwiązanie:

  1. Sprawdź konfigurację adresów:

    • W pliku wp-config.php dodaj następujące definicje:
      define('WP_HOME', 'https://twoja-domena.pl');
define('WP_SITEURL', 'https://twoja-domena.pl');

  2. Wyczyść cache przeglądarki:

    • Usuń pliki cookie i cache w Twojej przeglądarce
    • Spróbuj użyć trybu incognito/prywatnego

  3. Edytuj bazę danych:

    • Zaloguj się do phpMyAdmin przez DirectAdmin
    • Przejdź do tabeli wp_options
    • Znajdź i zmodyfikuj rekordy siteurl oraz home, aby zawierały prawidłowy adres URL

Problem z automatycznymi aktualizacjami

WordPress może mieć problemy z wykonywaniem automatycznych aktualizacji, zwłaszcza gdy wymaga to danych FTP.

Rozwiązanie:

Dodaj następujące linie do pliku wp-config.php:

define('FS_METHOD', 'direct');
define('FTP_BASE', '/ścieżka/do/wordpress/');
define('FTP_CONTENT_DIR', '/ścieżka/do/wordpress/wp-content/');
define('FTP_PLUGIN_DIR', '/ścieżka/do/wordpress/wp-content/plugins/');
define('FTP_USER', 'nazwa_użytkownika_ftp');
define('FTP_PASS', 'hasło_do_ftp');
define('FTP_HOST', 'localhost');

Zastąp /ścieżka/do/wordpress/ ścieżką do głównego katalogu WordPress na Twoim koncie hostingowym.

Strona wyświetla komunikaty o błędach PHP

Jeśli na Twojej stronie publicznej widoczne są ostrzeżenia lub błędy PHP, powinieneś je ukryć.

Rozwiązanie:

  1. Wyłącz wyświetlanie błędów: Dodaj lub zmodyfikuj następujące linie w pliku wp-config.php:

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

  2. Alternatywnie, loguj błędy bez wyświetlania:

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

Błąd złośliwego przekierowania (Redirect Loop)

Problem z niekończącym się przekierowaniem strony, który powoduje błąd ERR_TOO_MANY_REDIRECTS w przeglądarce.

Przyczyny:

  • Konflikt między HTTP i HTTPS
  • Niewłaściwa konfiguracja w pliku .htaccess
  • Problemy z wtyczkami cache lub zabezpieczającymi

Rozwiązanie:

  1. Sprawdź plik .htaccess:

    • Pobierz kopię pliku .htaccess i zmodyfikuj reguły przekierowań
    • Usuń zduplikowane reguły przekierowań

  2. Deaktywuj wtyczki związane z cache i zabezpieczeniami:

    • Wtyczki typu W3 Total Cache, WP Super Cache, Wordfence mogą powodować te problemy
    • Zmień nazwę katalogu wp-content/plugins/nazwa-problematycznej-wtyczki

  3. Wymuszenie HTTPS w wp-config.php:

    define('FORCE_SSL_ADMIN', true);

Typowe błędy JavaScript w WordPress

Problemy z JavaScript mogą powodować, że funkcje strony przestają działać prawidłowo.

Przyczyny:

  • Konflikty między skryptami wtyczek
  • Problemy z jQuery
  • Błędy w kodzie motywu

Rozwiązanie:

  1. Sprawdź błędy w konsoli przeglądarki:

    • Otwórz narzędzia deweloperskie w przeglądarce (F12)
    • Przejdź do zakładki "Console"
    • Zanotuj wyświetlane błędy

  2. Włącz debugowanie skryptów: Dodaj do pliku wp-config.php:

    define('SCRIPT_DEBUG', true);

  3. Rozwiąż konflikty jQuery: Dodaj do funkcji motywu:

    function fix_jquery_conflict() {
    wp_deregister_script('jquery');
    wp_register_script('jquery', 'https://ajax.googleapis.com/ajax/libs/jquery/3.6.0/jquery.min.js', false, '3.6.0');
    wp_enqueue_script('jquery');
}
add_action('wp_enqueue_scripts', 'fix_jquery_conflict');

Problemy po aktualizacji PHP

Po aktualizacji wersji PHP w DirectAdmin, WordPress może wykazywać problemy związane z kompatybilnością.

Rozwiązanie:

  1. Sprawdź logi błędów:

    • Przejdź do sekcji "Error Logs" w DirectAdmin
    • Sprawdź, które wtyczki lub motywy powodują problemy z nowszą wersją PHP

  2. Sprawdź kompatybilność wtyczek:

    • Użyj wtyczki "PHP Compatibility Checker" aby znaleźć problemy
    • Aktualizuj problematyczne wtyczki lub rozważ ich zastąpienie

  3. Tymczasowo zmień wersję PHP:

    • W DirectAdmin przejdź do "Wybór wersji PHP dla domeny"
    • Wybierz starszą wersję PHP, z którą strona działała poprawnie
    • Pamiętaj, że jest to tylko rozwiązanie tymczasowe

Powiązane Artykuły:

Tagi

wordpress troubleshooting bazy danych php błędy

Czy ten artykuł był pomocny?

Twoja strona WordPress działa wolno?

Sprawdź nasz hosting WordPress z ultraszybkimi dyskami NVMe i konfiguracją serwera zoptymalizowaną pod kątem wydajności. Doświadcz różnicy już dziś!

Sprawdź ofertę hostingu
30-dniowa gwarancja zwrotu pieniędzy