Błąd połączenia z bazą danych WordPress – co sprawdzić krok po kroku?

Komunikat „Error establishing a database connection” (po polsku „Błąd podczas nawiązywania połączenia z bazą danych”) oznacza, że WordPress nie może połączyć się z bazą MySQL. Najczęściej winne są błędne dane w pliku wp-config.php, niedostępny serwer bazy danych, uszkodzone tabele albo ostatnia zmiana: przeniesienie strony, zmiana hasła w panelu hostingu, aktualizacja. Sprawdzaj te przyczyny w tej kolejności, od najprostszej. Kopię zapasową przywracaj dopiero wtedy, gdy wiesz, co się stało.

Poniżej każdy krok z instrukcją, co dokładnie sprawdzić, oraz lista informacji, które warto mieć pod ręką, gdy trzeba napisać do hostingu.

Co oznacza ten błąd

Każda strona w WordPressie jest składana na bieżąco z danych zapisanych w bazie MySQL: treści, ustawień, użytkowników. Gdy połączenie z bazą nie działa, WordPress nie ma czego wyświetlić, więc pokazuje tylko komunikat o błędzie – zarówno na stronie, jak i w panelu /wp-admin.

Część odwiedzających może jeszcze przez chwilę widzieć stronę z pamięci podręcznej (cache), więc to, że u kogoś „działa”, niczego nie wyklucza. Sprawdzaj w oknie prywatnym przeglądarki.

Jedna wskazówka na start: jeśli pod adresem /wp-admin zobaczysz inny komunikat – że tabele bazy są niedostępne i baza może wymagać naprawy – od razu przejdź do kroku 3.

Krok 1: dane logowania w wp-config.php

Plik wp-config.php leży w głównym katalogu WordPressa. Pobierz go przez FTP (np. FileZillą) albo menedżer plików w panelu hostingu i sprawdź cztery wartości:

• DB_NAME – nazwa bazy danych,
• DB_USER – użytkownik bazy,
• DB_PASSWORD – hasło użytkownika bazy,
• DB_HOST – adres serwera bazy; często localhost, ale niektóre hostingi podają osobny adres lub port.

Porównaj je z danymi w panelu hostingu w sekcji baz danych MySQL. Wystarczy literówka, zbędna spacja albo hasło zmienione w panelu, a nie w pliku. Jeśli nie masz pewności co do hasła, ustaw nowe dla użytkownika bazy w panelu i wpisz je w wp-config.php. Przed każdą zmianą zapisz kopię pliku.

Krok 2: czy działa serwer MySQL

• Zaloguj się do phpMyAdmin w panelu hostingu tymi samymi danymi co w wp-config.php. Jeśli logowanie działa, a baza ma tabele (np. wp_posts, wp_options), serwer jest dostępny, a dane są poprawne.
• Sprawdź, czy działają inne strony na tym samym koncie hostingowym. Jeśli wszystkie mają ten sam błąd, problem leży zwykle po stronie serwera.
• Sprawdź w panelu, czy nie zabrakło miejsca na dysku albo nie przekroczono limitów konta.
• Przy nagłym skoku ruchu (albo zalewie botów) serwer może przekroczyć limit jednoczesnych połączeń z bazą. Błąd pojawia się wtedy i znika.

Krok 3: uszkodzone tabele

WordPress ma wbudowane narzędzie do naprawy bazy. Najpierw zrób kopię bazy (eksport w phpMyAdmin albo kopia w panelu hostingu), a potem:

1. Dodaj do wp-config.php, nad linią „That’s all, stop editing!”, wpis: define(’WP_ALLOW_REPAIR’, true);
2. Wejdź na adres twojadomena.pl/wp-admin/maint/repair.php.
3. Wybierz „Napraw bazę danych” (albo naprawę z optymalizacją).
4. Po zakończeniu usuń tę linię z wp-config.php. Strona naprawy działa bez logowania, więc zostawiona byłaby dostępna dla każdego.

Jeśli naprawa nie pomaga, zostaje przywrócenie samej bazy z kopii – w phpMyAdmin albo w panelu hostingu, gdzie zwykle wybierasz kopię z konkretnego dnia i przywracasz tylko bazę, bez plików.

Krok 4: co zmieniło się ostatnio

• Przeniesienie strony – po migracji często zostaje stary DB_HOST, niepełny import bazy albo inna nazwa bazy na nowym serwerze.
• Zmiana hasła – ktoś zmienił hasło użytkownika bazy w panelu, a nie zaktualizował pliku.
• Aktualizacja lub nowa wtyczka – rzadko wprost powoduje ten błąd, ale wtyczka generująca bardzo dużo zapytań może przeciążać bazę. Wyłączysz ją bez panelu, zmieniając przez FTP nazwę jej folderu w wp-content/plugins.
• Włamanie – jeśli wp-config.php zmienił się bez Twojej wiedzy albo na serwerze są nieznane pliki, potraktuj stronę jako zainfekowaną i zacznij od zabezpieczenia jej, a nie od przywracania kopii.

Kiedy pisać do hostingu

Jeśli dane w wp-config.php są poprawne, a phpMyAdmin nie działa albo nie działa żadna strona na koncie, zgłoś problem dostawcy. Przyspieszysz sprawę, gdy od razu podasz:

• dokładny komunikat i godzinę, od której występuje;
• czy działa logowanie do phpMyAdmin;
• czy ten sam błąd mają inne strony na koncie;
• czy był skok ruchu albo jakieś zmiany na stronie;
• prośbę o sprawdzenie serwera MySQL i limitów połączeń.

Zapytaj też o przewidywany czas usunięcia awarii. Do tego czasu nie wprowadzaj zmian na ślepo. Jeśli awarie się powtarzają, rozważ zmianę hostingu.

Jak zapobiegać

• Automatyczne kopie plików i bazy – codzienne, trzymane poza serwerem strony.
• Aktualizacje WordPressa, motywu i wtyczek dopiero po wykonaniu kopii.
• Monitoring dostępności, który powiadomi Cię o awarii, zanim zauważą ją klienci.
• Silne hasło do bazy i dostęp FTP tylko dla osób, które go potrzebują.

Jeśli nie chcesz pilnować tego sam, policz, ile kosztuje utrzymanie strony z opieką techniczną.

Kolejność działań przy błędzie bazy danych

Najpierw sprawdź dane w wp-config.php, potem dostępność MySQL w phpMyAdmin, następnie stan tabel i ostatnie zmiany na stronie. Jeśli problem leży po stronie serwera, zgłoś go hostingowi z konkretnymi informacjami. Nie przywracaj kopii w ciemno, a po użyciu narzędzia naprawy usuń z wp-config.php linię WP_ALLOW_REPAIR.

Strona dalej nie działa? Napisz do nas – pomożemy ją przywrócić.