Jak naprawić błąd połączenia z bazą danych WordPress?

Komunikat „Błąd łączenia się z bazą danych” oznacza, że WordPress nie może skomunikować się z serwerem MySQL. To błąd krytyczny, ale zwykle możliwy do usunięcia w kilkanaście minut. Strona najczęściej nadal istnieje – nie może tylko pobrać danych potrzebnych do jej wyświetlenia.

Co mogło wywołać błąd?

Najczęściej problem wynika z nieprawidłowych danych w pliku wp-config.php, zmiany hasła do bazy, awarii hostingu albo uszkodzenia tabel. Jeśli błąd pojawił się tuż po aktualizacji wtyczki, motywu lub ręcznej edycji plików, ostatnia zmiana również może być przyczyną.

Najpierw sprawdź hosting i wykonaj kopię zapasową

Zanim zmienisz pliki lub bazę danych, sprawdź komunikaty usługodawcy i skontaktuj się z hostingiem. Chwilowa awaria MySQL, przerwa techniczna albo przekroczenie limitu połączeń nie wymaga edycji WordPressa. Samodzielne zmiany w takim momencie mogą utrudnić późniejszą diagnozę.

Przed każdą edycją pobierz kopię plików WordPressa i bazy danych. Zapisz także oryginalny plik wp-config.php, aby móc natychmiast cofnąć zmianę. Jeśli hosting udostępnia automatyczne backupy, upewnij się, że obejmują zarówno pliki, jak i bazę MySQL.

Przygotuj podstawowe informacje, które mogą przyspieszyć pomoc techniczną:

• Nazwę serwera lub konta hostingowego.
• Moment, w którym po raz pierwszy pojawił się błąd.
• Ostatnie zmiany wykonane na stronie.
• Nazwę bazy danych i adres domeny.

Sprawdź dane w pliku wp-config.php

Plik wp-config.php znajduje się zwykle w głównym katalogu WordPressa, obok folderów wp-admin, wp-content i wp-includes. Otwórz go przez FTP, SFTP albo Menedżer plików w panelu hostingu. Najpierw pobierz plik na komputer i zachowaj jego niezmienioną kopię.

Wyszukaj cztery ustawienia odpowiadające za połączenie:

1. DB_NAME – sprawdź, czy wpisana nazwa jest identyczna z nazwą bazy w panelu hostingu.
2. DB_USER – zweryfikuj nazwę użytkownika przypisanego do tej bazy.
3. DB_PASSWORD – porównaj hasło z aktualnym hasłem użytkownika bazy.
4. DB_HOST – sprawdź adres serwera bazy danych. Często jest to localhost, ale nie każdy hosting korzysta z tej wartości.

Przykładowy fragment może wyglądać tak:

define( 'DB_NAME', 'nazwa_bazy' );
define( 'DB_USER', 'uzytkownik_bazy' );
define( 'DB_PASSWORD', 'haslo_bazy' );
define( 'DB_HOST', 'localhost' );

Nie kopiuj przykładowych wartości bez sprawdzenia ich w panelu usługodawcy. Zwróć uwagę na wielkość liter, podkreślenia, spacje i znaki specjalne. Jeśli zmieniasz hasło w panelu hostingu, wpisz dokładnie to samo hasło w pliku.

Po zapisaniu prześlij plik na serwer i sprawdź stronę. Jeżeli błąd się nasilił albo pojawił się błąd składni, przywróć zachowaną kopię. Edytuj plik w zwykłym edytorze tekstowym, zapisując go jako UTF-8 bez BOM. Nieprawidłowe kodowanie znaków może dodać niewidoczne znaki i uniemożliwić uruchomienie WordPressa.

Napraw uszkodzone tabele bazy danych

Jeżeli dane w wp-config.php są poprawne, a hosting potwierdza prawidłowe działanie MySQL, przyczyną może być uszkodzenie tabel. WordPress ma wbudowane narzędzie naprawcze, ale wymaga ono chwilowej zmiany w pliku konfiguracyjnym.

1. Pobierz kopię wp-config.php przed rozpoczęciem pracy.
2. Otwórz plik i dodaj przed komentarzem kończącym edycję konfiguracji linię define( 'WP_ALLOW_REPAIR', true );.
3. Wejdź w przeglądarce na adres https://twojadomena.pl/wp-admin/maint/repair.php, zastępując domenę własnym adresem.
4. Uruchom naprawę bazy, a jeśli narzędzie oferuje taką opcję, także naprawę i optymalizację.
5. Po zakończeniu usuń dodaną linię z wp-config.php i zapisz plik.

Usunięcie tej stałej jest konieczne, ponieważ strona naprawcza nie jest chroniona logowaniem do panelu administracyjnego. Pozostawienie jej na serwerze niepotrzebnie zwiększa ryzyko ingerencji w bazę. Jeśli naprawa nie pomoże, przywróć kopię pliku i nie wykonuj kolejnych zmian bez sprawdzenia logów lub konsultacji z hostingiem.

Wyklucz konflikt wtyczki lub motywu

Jeśli błąd wystąpił po aktualizacji albo instalacji dodatku, wyłącz wtyczki bez dostępu do panelu WordPress. Połącz się przez FTP lub Menedżer plików i przejdź do katalogu wp-content. Zmień nazwę folderu plugins na przykład na plugins_old, a następnie sprawdź stronę.

Jeśli witryna zacznie działać, przyczyną jest prawdopodobnie jedna z wtyczek. Przywróć nazwę folderu plugins, a potem zmieniaj nazwy katalogów poszczególnych wtyczek pojedynczo. Po każdym kroku sprawdzaj stronę. Aby cofnąć test, przywróć pierwotną nazwę folderu.

Gdy wyłączenie wtyczek nie pomaga, możesz analogicznie tymczasowo zmienić nazwę folderu themes. Zachowaj kopię przed zmianą i przywróć oryginalną nazwę po zakończeniu testu.

Kiedy poprosić hosting o pomoc?

Przerwij samodzielne działania, jeśli poprawne dane logowania, naprawa tabel i wyłączenie dodatków nie przywróciły strony. Support może sprawdzić stan serwera MySQL, uprawnienia użytkownika, limity połączeń, logi oraz ewentualne awarie infrastruktury.

Przed wysłaniem zgłoszenia upewnij się, że masz:

• Dokładny komunikat błędu wyświetlany przez WordPress.
• Godzinę wystąpienia problemu i informację, czy błąd nadal trwa.
• Opis ostatnich zmian w plikach, bazie, wtyczkach lub motywie.
• Informację, czy działa logowanie do phpMyAdmin i panelu hostingu.
• Nazwę bazy, serwera oraz identyfikator konta hostingowego.

Jeżeli problem pojawił się po infekcji, pustej bazie albo nieautoryzowanej zmianie pliku, nie ograniczaj się do samego przywrócenia strony. Zabezpiecz konto, zmień hasła i rozważ odtworzenie plików oraz bazy z kopii sprzed incydentu.

W przypadku lokalnej instalacji WordPressa sprawdź jeszcze, czy w XAMPP lub podobnym środowisku działa usługa MySQL. Sam uruchomiony serwer PHP nie wystarczy. Po włączeniu MySQL sprawdź stronę i przywróć wcześniejszy stan usług, jeśli zmiana nie rozwiąże problemu.

Najbezpieczniejsza kolejność to: backup, sprawdzenie hostingu, weryfikacja czterech wartości w wp-config.php, naprawa tabel, test wtyczek i dopiero potem przywrócenie kopii lub pomoc administratora.