Wie behebe ich den ‘Fehler beim Herstellen einer Datenbankverbindung' in WordPress

„Error Establishing a Database Connection“ ist eine Fehlermeldung, die Ihnen mitteilt, dass Ihre WordPress-Website keine Verbindung zu ihrer Datenbank herstellen kann. Es mag schwierig erscheinen, es zu beheben, aber zum Glück gibt es nur eine Handvoll Probleme, die es verursachen, und mit ein wenig Nachforschung und Fehlerbehebung können Sie das Problem leicht lösen.

Diese Anleitung erklärt, was „Fehler beim Herstellen einer Datenbankverbindung“ bedeutet, umreißt die häufigsten Ursachen und wie man sie behebt.

Was bedeutet der “Fehler beim Herstellen einer Datenbankverbindung” von WordPress?

Bevor wir uns den Fehler ansehen, müssen wir verstehen, wie WordPress funktioniert. Wie die meisten CMS-Anwendungen (Content Management System) besteht es aus zwei wesentlichen Teilen – Dateien und einer Datenbank.

Die Dateien sind das Gerüst der Website und enthalten die Kernfunktionen von WordPress, die Medien, Themes und Plugins.

Auf der anderen Seite enthält die Datenbank die benutzerdefinierten Einstellungen und den einzigartigen Inhalt der Website. Alle Seiten, Beiträge, Texte und Gestaltung werden als Einträge in den Tabellen erfasst.

Die Dateien kommunizieren mit der Datenbank über verschiedene PHP- und MySQL-Funktionen und extrahieren die auf den Webseiten visualisierten Daten.

Wenn Ihre Website keine Verbindung zur Datenbank herstellen kann, kann sie die zum Anzeigen der Seiten erforderlichen Daten nicht abrufen. WordPress warnt Sie vor dem Problem, indem es die Meldung „Error Establishing a Database Connection“ anzeigt, wie im Bild unten zu sehen ist.

Was sind die häufigsten Ursachen für „Fehler beim Herstellen einer Datenbankverbindung“?

Es gibt verschiedene Szenarien, in denen der Fehler auftritt. Zu den häufigsten gehören:

• Falsche Datenbankeinstellungen in der Konfigurationsdatei – Falsche Datenbankanmeldeinformationen sind wohl der häufigste Grund für eine unterbrochene Datenbankverbindung. Wenn Datenbankname, Benutzername, Passwort oder Hostname falsch sind, wird die Website keine Verbindung zur Datenbank herstellen und “Fehler beim Herstellen der Datenbankverbindung” zurückgeben.
• Unzureichende Datenbankbenutzerrechte – Ein weiterer Grund, warum der Fehler auftritt, ist, wenn der Datenbankbenutzer nicht über ausreichende Berechtigungen verfügt, selbst wenn die Anmeldeinformationen korrekt sind. Der Benutzer muss die Berechtigung haben, alle Arten von MySQL-Operationen auf der Datenbank auszuführen.
• Beschädigte Datenbanktabellen – WordPress ist ein hochdynamisches System, und jedes Mal, wenn Sie Änderungen an Ihrer Website vornehmen, werden die Tabellen der Datenbank geändert. Das Hinzufügen oder Löschen von Plugins und Themen erstellt neue Tabellen oder löscht bestehende, neue Seiten fügen neue Einträge hinzu, etc.
  Bei so vielen durchgeführten MySQL-Operationen können die Tabellen gelegentlich beschädigt werden, was zu einer anderen Variante des “Fehlers beim Herstellen einer Datenbankverbindung” führen könnte – “Eine oder mehrere Datenbanktabellen sind nicht verfügbar”.
• Falsche Website-URLs – In seltenen Fällen kann der “Fehler beim Herstellen einer Datenbankverbindung” durch falsche Website-URLs verursacht werden.
• Beschädigte WordPress-Dateien – Ein weiterer Grund, warum Sie die Meldung “Fehler beim Herstellen einer Datenbankverbindung” sehen, ist, dass die WordPress-Kerndateien Ihrer Website beschädigt sind. Dies kann auf eine Malware-Infektion, ein fehlgeschlagenes Update oder eine unvollständige Dateiübertragung bei manueller Übertragung Ihrer Website zurückzuführen sein.
• Der Datenbankserver ist ausgefallen oder überlastet.

Wie man „Fehler beim Herstellen einer Datenbankverbindung“ behebt

Auf den ersten Blick klingt der Fehler ziemlich einschüchternd und schwer zu beheben. Es läuft jedoch in der Regel auf ein paar wichtige Einstellungen hinaus, die leicht überprüft und behoben werden können.

Überprüfen Sie die wp-config.php-Datei Ihrer WordPress-Website

Die Einstellungen für die Datenbank werden in der Konfigurationsdatei jeder WordPress Installation gespeichert. Es heißt wp-config.php und befindet sich im Stammverzeichnis Ihrer Website.

Um die Datei zu überprüfen, loggen Sie sich in die Website-Ordner über FTP oder das Panel Ihres Hostings ein. Wenn Sie ein SiteGround-Benutzer sind, navigieren Sie zu Site Tools > Site > Dateimanager.

Das Stammverzeichnis jeder Website ist das Verzeichnis ihredomain.com/public_html. In unserem Beispiel ist der Website-Name sg-testing.com, also ist der Ordner sg-testing.com/public_html.

Bevor Sie Änderungen vornehmen, sollten Sie für alle Fälle ein Backup der Datei erstellen. Um das zu tun, klicken Sie mit der rechten Maustaste auf die Datei, wählen Sie Kopieren, und benennen Sie die kopierte Version in wp-config-backup.php um.

Nachdem Sie die Sicherungskopie erstellt haben, wählen Sie die Datei wp-config.php und wählen Bearbeiten.

Datenbankname, Benutzer, Passwort und Host sind in den folgenden Codezeilen definiert:

// ** Datenbankeinstellungen - Sie können diese Informationen von Ihrem Webhost erhalten ** //

/** Der Name der Datenbank für WordPress */

define('DB_NAME', 'datenbankname_hier');

/** Datenbankbenutzername */

define('DB_USER', 'benutzername_hier');

/** Datenbankpasswort */

define('DB_PASSWORD', 'passwort_hier');

/** Datenbank-Hostname */

define('DB_HOST', 'localhost');

Die Werte jeder Einstellung müssen mit der vorhandenen Datenbank, dem Benutzer und dem Passwort auf dem MySQL-Server der Website übereinstimmen. Nachdem Sie die Änderungen übernommen haben, klicken Sie auf das Symbol Speichern (Diskette).

Setzen Sie den richtigen Datenbank-Hostnamen

Der MySQL-Server wird durch die folgende Codezeile definiert:

define('DB_HOST', 'localhost');

Normalerweise befindet sich der Datenbankhost auf demselben Server wie die Dateien der Website. Daher ist der Wert „localhost“ oder „127.0.0.1“ und die gesamte Zeile lautet:

define('DB_HOST', 'localhost');

oder

define( 'DB_HOST', '127.0.0.1' );

Wenn Sie einen entfernten Datenbankhost angegeben haben, müssen Sie diese Werte durch den richtigen Hostnamen des entfernten Servers ersetzen.

Setzen Sie den richtigen Datenbanknamen

Nachdem der Host eingerichtet wurde, überprüfen Sie die Datenbankdetails auf dem MySQL-Server. SiteGround-Benutzer können die MySQL-Datenbankeinstellungen einfach über Site Tools > Site > MySQL aufrufen.

Um die Einstellungen aus der Datei wp-config.php mit den Details der MySQL Datenbank einfacher zu vergleichen, öffnen Sie den Abschnitt MySQL in einem neuen Browser-Tab, indem Sie mit der rechten Maustaste darauf klicken und Link in neuem Tab öffnen wählen.

Die vorhandenen Datenbanken auf dem MySQL Server sind in der Registerkarte Datenbanken unter Datenbanken verwalten aufgelistet.

Die dort aufgeführte Datenbank muss mit der in der Datei wp-config.php definierten übereinstimmen.

Kopieren Sie den Namen der Datenbank von MySQL > Datenbanken und fügen Sie ihn in die Codezeile in wp-config.php ein:

define('DB_NAME', 'datenbankname_hier');

Stellen Sie den richtigen Datenbankbenutzernamen ein

Um den Benutzer für die Datenbank zu sehen, klicken Sie auf den Link unter der Spalte Benutzer der Datenbank.

Es erscheint ein Popup-Fenster, in dem alle Benutzer mit Rechten zum Ändern der Datenbank der Website aufgelistet sind. Markieren Sie den Benutzernamen in der Spalte Benutzer und kopieren Sie ihn.

Gehen Sie zurück zum Bearbeiten der Datei wp-config.php und fügen Sie den Namen in die Zeile ein:

define('DB_USER', 'benutzername_hier');

Wenn kein Benutzer mit der Datenbank verbunden ist, gibt es keinen Link unter der Spalte Benutzer. Klicken Sie auf das Symbol Neuen Benutzer hinzufügen unter der Spalte Aktionen, um einen bestehenden Benutzer zur Datenbank der Website hinzuzufügen.

Im Popup-Fenster, wählen Sie einen der Namen aus dem Benutzer Dropdown-Menü, markieren Sie das Optionsfeld Alle Rechte, und drücken Sie Bestätigen.

Nachdem der Benutzer an die Datenbank angehängt wurde, können Sie seinen Namen kopieren und in die Datei wp-config.php einfügen.

Wenn keine Benutzer vorhanden sind, öffnen Sie den Abschnitt Site Tools > Site > MySQL > Benutzer. Sie können einen neuen Benutzer anlegen, indem Sie auf die Schaltfläche Benutzer erstellen klicken.

Der neue Benutzername wird im Abschnitt Benutzer verwalten auf der Registerkarte Benutzer erscheinen. Klicken Sie auf das Symbol Neue Datenbank hinzufügen, um den Benutzer an die Datenbank der Website anzuhängen.

Im Pop-up-Fenster, wählen Sie die Datenbank der Website, markieren Sie das Optionsfeld Alle Rechte, und drücken Sie Bestätigen.

Sie können dann den neuen Benutzernamen kopieren und in die entsprechende Zeile in der wp-config.php einfügen.

Setzen Sie das richtige Passwort des Datenbankbenutzers

Nachdem Sie den Benutzer in wp-config.php hinzugefügt haben, müssen Sie sicherstellen, dass das Passwort des Benutzers in der Datei mit seinem Gegenstück in MySQL übereinstimmt. Kopieren Sie den Passwort-String aus der Zeile in wp-config.php:

define('DB_PASSWORD', 'passwort_hier');

Nachdem das Passwort kopiert wurde, gehen Sie zurück zu Site > MySQL > Benutzer, drücken Sie die Kebab-Menü, und wählen Sie Passwort ändern.

Fügen Sie das Passwort in das Feld Neues Passwort ein und drücken Sie Bestätigen.

Der Fehler sollte beim Neuladen der Website verschwinden, wenn alle Anmeldeinformationen richtig gesetzt sind.

Überprüfen Sie, ob der Datenbankbenutzer die richtigen Berechtigungen hat

Um die Rechte des Benutzers zu überprüfen, gehen Sie zu Site Tools > Site > MySQL > Benutzer, und suchen Sie den Benutzer im Abschnitt Benutzer verwalten. Klicken Sie auf den Link unter der Spalte Datenbankzugriff, die ein neues Pop-up-Fenster öffnet.

Drücken Sie das Zugriff verwalten Symbol, um ein neues Fenster zu öffnen, in dem die Zugriffsoptionen verwaltet werden.

Um alle erforderlichen Berechtigungen zu setzen, wählen Sie den Radiobutton Alle Rechte und klicken auf den Button Bestätigen.

Repariere die Datenbank

Wenn Ihre Datenbank beschädigt ist, müssen Sie sie reparieren, und zum Glück hat WordPress einen eingebauten Reparaturmodus.

Um es zu aktivieren, müssen Sie die wp-config.php -Datei Ihrer Website über FTP oder Ihr Hosting-Control-Panel bearbeiten.

SiteGround-Benutzer können die Datei bearbeiten, indem sie zu Site Tools > Site > Dateimanager navigieren. Die Datei befindet sich im Stammverzeichnis der Website, das ihredomain.com/public_html ist (wo Sie ihredomain.com durch Ihre eigene Domain ersetzen müssen).

Wählen Sie wp-config.php und drücken Sie Bearbeiten.

Direkt über der Zeile “/* That’s all, stop editing! Happy publishing. */” fügen Sie den folgenden Code hinzu:

define('WP_ALLOW_REPAIR', true);

Bestätigen Sie die Änderungen durch Drücken des Symbols Speichern.

Um den Reparaturmodus zu laden, öffnen Sie die Seite https://ihredomain.com.com/wp-admin/maint/repair.php in Ihrem Browser, wobei ihredomain.com.com durch den Namen Ihrer Website ersetzt wird. Zum Beispiel, unser Name ist sg-testing.com, also wäre die Adresse https://sg-testing.com/wp-admin/maint/repair.php.

Wählen Sie zwischen den beiden Optionen Datenbank reparieren und Datenbank reparieren und optimieren, und wenn die Wartung abgeschlossen ist, laden Sie die Homepage Ihrer Website neu. Sobald Sie bestätigt haben, dass der Fehler behoben ist, entfernen Sie den Code, den Sie in wp-config.php hinzugefügt haben, damit niemand anderes den Reparaturmodus ausführen kann.

Überprüfen Sie die WordPress-Site-URL in der Datenbank

Der Fehler hindert Sie daran, sich in das Dashboard einzuloggen, in dem die URL der Website festgelegt ist. Sie können jedoch phpMyAdmin verwenden, um die Tabellen zu bearbeiten, in denen diese Einstellungen definiert sind.

SiteGround-Benutzer können das Tool erreichen, indem sie zu Site Tools > Site > MySQL > PHPMYADMIN > AUF PHPMYADMIN ZUGREIFEN navigieren.

Klicken Sie auf die Datenbank der Website in der linken Spalte und öffnen Sie die Tabelle wp_options.

Die Website-URLs werden in den Optionen siteurl und home definiert. Drücken Sie jeweils Edit, geben Sie die richtige Website-URL im Feld option_value ein und bestätigen Sie die Änderung mit der Schaltfläche Go.

Wiederherstellen ein Backup der Website

Wenn der Fehler nach einer manuellen Übertragung aufgetreten ist, exportieren Sie ein neues vollständiges Website-Backup vom vorherigen Hosting und importieren Sie es wieder in das neue Hosting.

Wenn die Website nicht übertragen wurde und der Fehler plötzlich auftritt, ist Ihre beste Wahl, die Website aus einem aktuellen Backup wiederherzustellen. In diesem Tutorial finden Sie das Backup-Tool von SiteGround.

Kontaktieren Sie den Webhosting-Provider

Die oben beschriebenen Lösungen funktionieren, wenn das Problem von der Konfiguration der Website herrührt. WordPress kann jedoch keine Verbindung zur Datenbank herstellen, wenn der MySQL-Server überlastet ist oder gewartet wird.

Wenn Sie Ihren eigenen Server verwalten, ziehen Sie in Betracht, den MySQL-Dienst neu zu starten, um alle festgefahrenen Datenbankabfragen zu löschen, die ihn überlasten.

Benutzer mit Managed Hosting haben diese Art von Zugriff nicht. Wenden Sie sich an das Support-Team Ihres Providers, damit sie den Status des Servers überprüfen und die Probleme von ihrer Seite lösen können.

Zusammenfassung

„Fehler beim Herstellen einer Datenbankverbindung“ ist ein weit verbreiteter WordPress-Fehler, dem Sie wahrscheinlich hin und wieder begegnen werden. Kurz gesagt, es informiert Sie, dass Ihre Website keine Verbindung zu ihrer Datenbank herstellen kann.

Während dieser Zeit ist Ihre Website nicht zugänglich, und Sie müssen sie reparieren, bevor Sie erheblichen Verkehr verlieren. Aber keine Sorge, es gibt nur eine kleine Anzahl von Ursachen, und mit ein wenig Fehlersuche können sie leicht ausgebügelt werden.

In diesem Handbuch wurden die häufigsten Ursachen für den Fehler beschrieben. Wenn Sie die Anweisungen sorgfältig befolgen, können Sie Ihre Website in kürzester Zeit wieder online schalten.