Uptime: 99,94% | Aktywne strony: 8 044
WordPress

Rozwiązywanie typowych błędów WordPress

Instrukcja diagnozowania i naprawy najczęstszych problemów z WordPressem na hostingu IQhost

5 min czytania 01.04.2025

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:

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
FAQ

Często zadawane pytania

Odpowiedzi na najczęstsze pytania związane z tym tematem

Jak znaleźć artykuł na interesujący mnie temat?

Możesz skorzystać z wyszukiwarki na górze strony, przeglądać artykuły według kategorii lub tagów. Wszystkie artykuły są pogrupowane tematycznie, co ułatwia znalezienie potrzebnych informacji.

Czy mogę zgłosić sugestię nowego artykułu?

Tak, zachęcamy do zgłaszania propozycji nowych tematów do naszej bazy wiedzy. Możesz to zrobić poprzez formularz kontaktowy, wybierając kategorię "Sugestia do bazy wiedzy".

Jak często aktualizowane są artykuły?

Regularnie aktualizujemy naszą bazę wiedzy, aby zawierała najnowsze informacje. Data aktualizacji jest widoczna przy każdym artykule, dzięki czemu wiesz, czy informacje są aktualne.

Nie znalazłem odpowiedzi na moje pytanie. Co teraz?

Jeśli nie znalazłeś odpowiedzi w naszej bazie wiedzy, zawsze możesz skontaktować się z naszym zespołem wsparcia. Jesteśmy dostępni poprzez czat, e-mail oraz telefon i chętnie pomożemy w rozwiązaniu Twojego problemu.