Błąd łączenia się z bazą danych w WordPressie: co oznacza

Co mówi komunikat

Przy każdym wyświetleniu strony WordPress otwiera połączenie z bazą danych MySQL lub MariaDB, korzystając z czterech informacji zapisanych w wp-config.php, w katalogu głównym strony:

define( 'DB_NAME', 'nazwa_bazy' );
define( 'DB_USER', 'uzytkownik' );
define( 'DB_PASSWORD', 'haslo' );
define( 'DB_HOST', 'localhost' );

„Błąd łączenia się z bazą danych” oznacza, że to połączenie się nie powiodło. Wywołują to cztery przyczyny: dane dostępowe, które już nie pasują, serwer bazy danych zatrzymany lub nieosiągalny, przeciążony serwer albo uszkodzona baza. Kolejne sekcje omawiają je od najłatwiejszej do sprawdzenia po najrzadszą.

1. Czy serwer bazy danych odpowiada?

• Strona stanu usług firmy hostingowej: ogłasza awarię lub prace serwisowe serwera MySQL.
• Inne strony na tym samym koncie: jeśli w tym samym czasie wyświetlają ten sam błąd, przyczyna leży po stronie serwera, a naprawa po stronie firmy hostingowej.
• phpMyAdmin, z panelu firmy hostingowej: jeśli otwiera bazę i pokazuje jej tabele, serwer działa, a baza istnieje.

Jeśli przyczyną jest serwer, proszę otworzyć zgłoszenie u firmy hostingowej, podając godzinę początku awarii i dokładny komunikat. W tym czasie na stronie nie trzeba niczego zmieniać.

2. Czy dane dostępowe w wp-config.php są prawidłowe?

To najczęstsza przyczyna po przeniesieniu strony, zmianie hasła do bazy w panelu firmy hostingowej lub przywróceniu kopii. Proszę porównać cztery wartości z wp-config.php z sekcją baz danych w panelu firmy hostingowej:

• DB_NAME i DB_USER: wiele firm hostingowych poprzedza je nazwą konta (konto_wordpress). Prefiks jest częścią nazwy.
• DB_PASSWORD: w razie wątpliwości proszę ustawić nowe hasło dla użytkownika w panelu i wpisać je w pliku.
• DB_HOST: localhost u wielu firm hostingowych, ale nie u wszystkich. Niektóre podają nazwę serwera lub adres, czasem z portem (:3306). Dokładna wartość jest w panelu.
• Użytkownik musi mieć uprawnienia do bazy: proszę sprawdzić w panelu, czy użytkownik jest przypisany do bazy, ze wszystkimi uprawnieniami.

Hasło zawierające apostrof (') przerywa otaczający je ciąg PHP w wp-config.php. Proszę poprzedzić apostrof ukośnikiem wstecznym (\') albo wybrać hasło bez apostrofu.

Przetestować dane dostępowe poza WordPressem

WordPress wyświetla ogólny komunikat. MySQL natomiast mówi dokładnie, co jest nie tak. Oto dwa sposoby, aby to sprawdzić z wartościami z wp-config.php:

Z wiersza poleceń, jeśli mają Państwo dostęp SSH

mysql -h localhost -u uzytkownik -p nazwa_bazy

Z WP-CLI polecenie wp db check czyta bezpośrednio wp-config.php i sprawdza tabele z tymi danymi dostępowymi.

Tymczasowym plikiem PHP

Proszę umieścić ten plik w katalogu głównym strony pod trudną do odgadnięcia nazwą, otworzyć go w przeglądarce, a potem od razu go usunąć: zawiera hasło do bazy.

<?php
mysqli_report(MYSQLI_REPORT_OFF);
$polaczenie = @mysqli_connect('localhost', 'uzytkownik', 'haslo', 'nazwa_bazy');
echo $polaczenie ? 'Połączenie udane' : 'Błąd: ' . mysqli_connect_error();

Pierwszy wiersz ma znaczenie: od PHP 8.1 nieudane połączenie domyślnie zgłasza wyjątek, a strona pozostałaby biała zamiast wyświetlić komunikat MySQL.

3. Uszkodzona baza: narzędzie naprawy

Gdy dane dostępowe są prawidłowe, ale tabele są uszkodzone, publiczna strona wyświetla ten sam komunikat o błędzie połączenia, a panel administracyjny dokładniejszy: „Jedna lub więcej tabel w bazie danych jest niedostępnych. Baza danych może musieć zostać naprawiona.” WordPress ma do tego narzędzie. Proszę dodać ten wiersz do wp-config.php:

define( 'WP_ALLOW_REPAIR', true );

Następnie proszę otworzyć https://www.panstwa-strona.com/wp-admin/maint/repair.php i uruchomić „Napraw bazę danych”. Proszę usunąć ten wiersz zaraz po zakończeniu naprawy: dopóki jest w pliku, ta strona jest dostępna dla każdego, bez logowania.

Przed naprawą proszę wyeksportować bazę (wp db export lub eksport w phpMyAdmin). Jeśli naprawa się nie powiedzie, firma hostingowa może przywrócić bazę ze swoich kopii zapasowych.

4. Błąd, który pojawia się i znika: obciążenie

Błąd, który pojawia się o określonych godzinach i znika sam, wskazuje raczej na przeciążony serwer niż na błędne ustawienie. Najczęstsze przyczyny:

• Szczyt ruchu, często roboty: powtarzane próby logowania na wp-login.php lub xmlrpc.php, widoczne w logach dostępu firmy hostingowej.
• Limity hostingu współdzielonego: liczba jednoczesnych połączeń lub procesów ograniczona dla każdego konta. Panel firmy hostingowej pokazuje je zwykle w sekcji zużycia zasobów.
• Ciężka wtyczka: statystyki, logi lub zaplanowane zadania, które przy każdej wizycie zapisują dane w bazie.

Rozwiązania: zablokować nadmierne próby logowania, zainstalować pamięć podręczną stron, wyłączyć xmlrpc.php, jeśli nie używa go żadna aplikacja, i poprosić firmę hostingową o logi z okresu błędu.