Jak naprawić błąd „Błąd nawiązywania połączenia z bazą danych” w WordPressie

Błąd „Błąd nawiązywania połączenia z bazą danych” (po angielsku „Error establishing a database connection”) oznacza, że WordPress nie potrafi połączyć się z bazą MySQL, w której trzyma wszystkie treści strony — wpisy, strony, ustawienia, dane użytkowników. Zamiast strony widzisz pustą, białą stronę z jednym zdaniem komunikatu. Najczęstsze przyczyny to błędne dane logowania do bazy w pliku wp-config.php, przejściowa awaria serwera bazy danych po stronie hostingu, uszkodzone tabele w bazie albo przekroczenie limitu zasobów przydzielonych do Twojego konta. Poniższe kroki prowadzą Cię przez diagnozę od najprostszej i najczęstszej przyczyny do bardziej złożonych.

1. Sprawdź, czy problem dotyczy tylko Twojej strony, czy całego serwera — zaloguj się do panelu hostingowego (cPanel, DirectAdmin lub panel własny hostingu) i sprawdź, czy w panelu widać komunikaty o awarii usług, albo spróbuj otworzyć inną stronę działającą na tym samym koncie hostingowym, jeśli taką masz.
2. Zaloguj się do File Managera w panelu hostingowym albo przez FTP i odnajdź plik wp-config.php w głównym katalogu instalacji WordPressa (zwykle jest to katalog public_html albo katalog z nazwą Twojej domeny).
3. Otwórz plik wp-config.php w trybie edycji i odszukaj cztery linie z danymi: DB_NAME (nazwa bazy), DB_USER (użytkownik bazy), DB_PASSWORD (hasło) oraz DB_HOST (adres serwera bazy).
4. Zaloguj się do sekcji „Bazy danych MySQL” w panelu hostingowym i porównaj te cztery wartości z tym, co widzisz w panelu — nazwę bazy, nazwę użytkownika oraz to, czy użytkownik jest w ogóle przypisany do tej bazy z odpowiednimi uprawnieniami.
5. Jeśli dane w wp-config.php się nie zgadzają albo nie masz pewności co do hasła, zresetuj hasło użytkownika bazy danych w panelu hostingowym, a następnie wpisz to nowe hasło w linii DB_PASSWORD w pliku wp-config.php i zapisz plik.
6. Sprawdź wartość DB_HOST — w większości przypadków poprawna wartość to localhost, ale część hostingów używa innej nazwy serwera bazy (np. adresu podanego w panelu przy danych bazy); jeśli Twój hosting podaje inną wartość, wpisz ją dokładnie w to pole.
7. Sprawdź w panelu hostingowym status usługi bazy danych (MySQL lub MariaDB) — jeśli panel pokazuje, że usługa jest zatrzymana albo niedostępna, nie jest to coś, co naprawisz samodzielnie, i powinieneś od razu zgłosić to do supportu hostingu.
8. Sprawdź, czy baza danych, z której korzysta Twoja strona, nadal istnieje na liście baz w panelu i czy przypisany do niej użytkownik nie został przypadkowo usunięty lub odłączony od tej bazy.
9. Jeśli powyższe dane są poprawne, a błąd nadal występuje, spróbuj uruchomić wbudowane narzędzie naprawy bazy WordPressa — dodaj w wp-config.php (nad linią „That's all, stop editing!”) linię define('WP_ALLOW_REPAIR', true);, zapisz plik, a następnie wejdź w przeglądarce na adres twojadomena.pl/wp-admin/maint/repair.php i uruchom naprawę oraz optymalizację tabel bazy.
10. Po zakończeniu naprawy koniecznie usuń dodaną linię define('WP_ALLOW_REPAIR', true); z pliku wp-config.php — pozostawiona na stałe pozwala każdemu, kto zna adres, uruchamiać naprawę Twojej bazy.
11. Jeśli błąd pojawia się głównie przy większym ruchu na stronie, sprawdź w panelu hostingowym limity zasobów bazy danych (np. liczbę dopuszczalnych jednoczesnych połączeń) i skontaktuj się z hostingiem z pytaniem, czy limit został przekroczony oraz czy możliwe jest jego zwiększenie lub przejście na wyższy plan.
12. Jeśli żaden z powyższych kroków nie pomógł, skontaktuj się z supportem hostingu i poproś o sprawdzenie logów serwera bazy danych od strony serwera — hosting widzi tam błędy (np. dotyczące uszkodzonego dysku, awarii usługi czy limitów systemowych), których nie zobaczysz z poziomu panelu klienta.

Co zrobić, gdy coś pójdzie nie tak

Błąd nadal występuje, mimo że dane logowania są poprawne. Sprawdź w panelu hostingowym, czy użytkownik bazy ma faktycznie przypisane uprawnienia do tej konkretnej bazy — samo istnienie użytkownika i bazy osobno nie wystarczy, muszą być ze sobą powiązane z pełnymi uprawnieniami. Warto też sprawdzić, czy w pliku wp-config.php prefiks tabel (zmienna $table_prefix) zgadza się z prefiksem tabel faktycznie znajdujących się w bazie — jeśli ktoś kiedyś zmieniał ten prefiks lub przywracał bazę z kopii zapasowej, oba prefiksy mogą się różnić.

Nie widzisz pliku wp-config.php w File Managerze albo nie masz do niego dostępu. Upewnij się, że w ustawieniach File Managera włączona jest opcja pokazywania plików ukrytych — w niektórych panelach wp-config.php bywa traktowany jako plik systemowy i domyślnie schowany. Sprawdź też, czy jesteś we właściwym katalogu — czasem WordPress jest zainstalowany w podkatalogu, a nie bezpośrednio w public_html. Jeśli nie masz danych dostępowych do FTP lub File Managera, poproś o nie support hostingu, podając się jako właściciel konta.

Błąd pojawia się tylko czasami, zwłaszcza przy większym ruchu na stronie. To zwykle nie jest problem z samymi danymi logowania, tylko z przekroczeniem limitu jednoczesnych połączeń do bazy danych, jaki hosting przydzielił Twojemu kontu — typowe dla tańszych planów hostingu współdzielonego. W takiej sytuacji zgłoś się do hostingu z pytaniem o limit połączeń do bazy i możliwość jego zwiększenia; jeśli problem wraca regularnie przy każdym większym ruchu, może to być sygnał, że warto rozważyć plan z większymi zasobami. Jak dokładnie testujemy wydajność hostingów pod obciążeniem, opisujemy na stronie /jak-testujemy.