Fehler beim Herstellen der Datenbankverbindung: Was Sie in WordPress prüfen sollten

So erkennen Sie das Problem

• Die Website zeigt die Meldung „Error establishing a database connection“ oder „Fehler beim Herstellen der Datenbankverbindung“
• Sie können sich nicht bei `/wp-admin` anmelden, es erscheint derselbe Fehler
• Die Website lief gestern noch, ist jetzt aber vollständig nicht erreichbar
• Der Fehler ist nach einer Passwortänderung oder einem Umzug der Website zu einem anderen Hosting-Anbieter aufgetreten

Häufigste Ursachen

Lösung Schritt für Schritt

1. 1

   Notieren Sie die genaue Fehlermeldung

   Öffnen Sie die Website und schreiben Sie die vollständige Meldung einschließlich einer eventuellen Fehlernummer ab. Wenn nur eine allgemeine Meldung sichtbar ist, speichern Sie eine Kopie von wp-config.php und aktivieren Sie vorübergehend die Fehleranzeige mit den Zeilen define('WP_DEBUG', true); und define('WP_DEBUG_DISPLAY', true);. Tun Sie dies nur kurz und nicht auf einer öffentlichen Website, da Besucher die Meldungen sehen können; schalten Sie sie danach unbedingt wieder aus. Der genaue Text grenzt die Ursache stark ein.

2. 2

   Prüfen Sie, ob der MySQL-Server läuft

   Prüfen Sie im Hosting-Panel (cPanel, Plesk oder ähnlich) oder auf der Statusseite des Hostings, ob der MySQL-Dienst verfügbar ist und ob das Ressourcenlimit erreicht wurde. Wenn der Server ausgefallen ist oder das Verbindungslimit erreicht wurde, warten Sie auf die Wiederherstellung oder kontaktieren Sie den Hosting-Support. Wenn andere Websites auf demselben Hosting funktionieren, liegt das Problem wahrscheinlich bei Ihrer Datenbank.

3. 3

   Öffnen Sie wp-config.php und prüfen Sie die Angaben

   Öffnen Sie über einen FTP-Client oder den Dateimanager im Panel die Datei wp-config.php im Stammverzeichnis der Website. Vergleichen Sie die Werte von DB_NAME, DB_USER, DB_PASSWORD und DB_HOST mit den Angaben im Hosting-Panel. Achten Sie auf Leerzeichen, Groß- und Kleinschreibung und darauf, ob das Passwort in Anführungszeichen steht.

4. 4

   Prüfen Sie den Datenbankbenutzer und die Rechte

   Öffnen Sie im Hosting-Panel den Bereich für MySQL-Datenbanken und Benutzer. Stellen Sie sicher, dass der Benutzer aus wp-config.php existiert, genau dieser Datenbank zugewiesen ist und alle Rechte hat. Wenn nicht, weisen Sie ihn erneut zu oder setzen Sie das Passwort zurück und tragen Sie das neue in wp-config.php ein.

5. 5

   Prüfen Sie DB_HOST und Port

   Wenn das Hosting einen separaten Datenbankserver verwendet, ist DB_HOST nicht localhost, sondern der Name oder die IP-Adresse, die Ihnen das Hosting genannt hat, manchmal mit Port in der Form servername:3306. Suchen Sie den genauen Wert in der Hosting-Dokumentation oder im Panel und tragen Sie ihn in wp-config.php ein.

6. 6

   Erstellen Sie vor weiteren Änderungen eine Sicherung

   Bevor Sie die Datenbank anfassen, laden Sie eine Kopie der Dateien herunter und exportieren Sie die Datenbank über phpMyAdmin oder die Tools des Hostings. Speichern Sie auch eine Kopie von wp-config.php. So können Sie zum vorherigen Zustand zurückkehren, wenn etwas schiefgeht.

7. 7

   Prüfen Sie, ob Datenbank und Tabellen existieren

   Prüfen Sie in phpMyAdmin, ob die Datenbank mit dem Namen aus wp-config.php existiert und ob sie Tabellen mit dem Präfix enthält, das $table_prefix entspricht. Wenn die Tabellen leer sind oder fehlen, wurde die Datenbank wahrscheinlich gelöscht oder der Import ist fehlgeschlagen.

8. 8

   Reparieren Sie die Tabellen, wenn sie beschädigt sind

   Markieren Sie in phpMyAdmin die Tabellen und wählen Sie die Option zur Reparatur (Repair table). Wenn die Reparatur nicht hilft, stellen Sie die Datenbank aus dem letzten Backup wieder her. Prüfen Sie nach der Wiederherstellung erneut die Angaben in wp-config.php.

9. 9

   Testen Sie die Website und schalten Sie Debug aus

   Öffnen Sie die Website und /wp-admin in einem Inkognito-Fenster des Browsers. Wenn sie lädt, entfernen Sie die Zeilen WP_DEBUG und WP_DEBUG_DISPLAY oder setzen Sie sie auf false. Wenn der Fehler bleibt, kehren Sie zum Schritt mit der Prüfung von Benutzer und Host zurück.

Wenn nichts hilft

So beugen Sie vor

• Erstellen Sie regelmäßig automatisierte Backups von Datenbank und Dateien und prüfen Sie, ob sie erfolgreich wiederhergestellt werden können
• Ändern Sie das Passwort des Datenbankbenutzers nicht, ohne es gleichzeitig in `wp-config.php` zu ändern
• Dokumentieren Sie die Datenbankangaben vor jedem Umzug der Website
• Überwachen Sie die MySQL-Ressourcennutzung und die Anzahl der Verbindungen im Hosting-Panel

Häufige Fragen