So beheben Sie den WordPress-Datenbankfehler "Error establishing a database connection"

Webseiten, die auf WordPress basieren, nutzen zum größten Teil Datenbanken, welche wiederum das Datenbankverwaltungssystem "MySQL" einsetzen. Beim Aufruf Ihrer Webseite werden über PHP-Befehle die benötigten Einträge aus der Datenbank abgerufen und anschließend im Browser dargestellt. Die Fehlermeldung Error establishing a database connection besagt, dass beim Aufbau der Verbindung zur Wordpressdatenbank ein Fehler aufgetreten ist. Leider gibt die Fehlermeldung keine Auskunft darüber, weshalb der Fehler aufgetreten ist.

Sollten Sie den Fehler beim Aufruf Ihrer Webseite erhalten, dann müssen Sie jedoch nicht gleich zu drastischen Maßnahmen wie eine Neuinstallation oder Wiederherstellung Ihrer Webseite greifen. Glücklicherweise gibt es einige Ansätze, das Problem trotz der Fehlermeldung Error establishing a database connection zu beheben. Welche Möglichkeiten es gibt und wie Sie das Problem lösen können, erklären wir Ihnen im nachfolgenden Artikel.

Welche Ursachen können den Fehler "Error establishing a database connection" auslösen?

Wie auch andere Hard- und Softwaresysteme laufen Datenbanksysteme die meiste Zeit problemlos und sind in der Regel stets verfügbar. In den meisten Fällen tritt der Fehler auf, wenn die Anmeldedaten für die Datenbank nicht korrekt in der WordPress-Konfiguration hinterlegt sind oder die Datenbank an sich einen Fehler enthält. Dies kann z.B. durch ein Plugin ausglöst werden, welches ohne Ihre Veranlassung Änderungen in der Datenbank vornimmt.

Sollte es zu einer Fehlfunktion kommen, ist es entscheidend, die genaue Ursache zu identifizieren, um den Fehler beheben zu können. Die Fehlermeldung Error establishing a database connection kann durch unterschiedliche Faktoren verursacht werden. Dabei ist es wichtig, nicht sofort in Panik zu geraten, sondern zunächst systematisch den Grund für das Problem zu finden und es dann gezielt zu beheben. 

Falls Sie sich unsicher fühlen, Befehle eigenständig im Adminbereich einzugeben, ist es ratsam, den Support Ihres Webhostinganbieters zu kontaktieren. Es kann auch vorkommen, dass ein Wechsel des Webhosters zu dieser Fehlermeldung führt. In solchen Fällen hilft Ihnen Ihr Anbieter meist durch spezifische Anweisungen und Hilfe-Seiten weiter. Im Folgenden zeigen wir Ihnen, wie Sie die häufigsten Ursachen dieser Fehlermeldung identifizieren und beheben können.

Überprüfung des Admin- und des Startbereichs

Content-Management-Systeme (CMS) wie WordPress benötigen meist eine Datenbank, weswegen in der Folge eine Datenbankverbindung aufgebaut werden muss. Die Verwaltung von WordPress erfolgt über einen Adminbereich, worüber diverse Einstellungen vorgenommen oder auch z.B. Plugins installiert werden können. Wenn Sie nun die Startseite Ihrer Webseite sowie den Adminbereich aufrufen und unterschiedliche Fehlermeldungen (z.B. „One or more database tables are unavailable. The database may need to be repaired“) erhalten, dann können Sie davon ausgehen, dass die Verbindung aufgrund einer beschädigten Datenbank nicht mehr hergestellt werden kann. Dieses Problem kann entstehen, wenn die Verbindung zur Datenbank abbricht während Einträge vorgenommen werden. In diesem Fall sollten Sie unbedingt die beschädigte Datenbank reparieren.

Wie kann ich die Reparatur einer beschädigten Datenbank durchführen?

Sollten Sie, wie zuvor beschrieben, im Admin- und Startbereich unterschiedliche Fehlermeldungen erhalten und davon ausgehen, dass Ihre WordPress-Datenbank beschädigt ist, dann müssen Sie eine Reparatur der Datenbank durchführen. Hierzu gibt es unterschiedliche Möglichkeiten, die Sie nutzen können. Einige Webhoster stellen Ihnen spezielle Tools zur Verfügung, die Sie nur noch aktivieren müssen. Wenn Ihr Webhoster für die Verwaltung der Datenbank das Tool "phpMyAdmin" nutzt, dann haben Sie die Möglichkeit die Datenbanktabellen direkt auszuwählen und die Option "Repariere Tabelle" auszuwählen. Anschließend sollte das Tool die Datenbank bzw. den beschädigten Bereich reparieren.

Wie kann ich die Reparatur der beschädigten Datenbank über WordPress durchführen?

Alternativ können Sie auch durch das Einfügen eines Reparaturbefehls in die Datei "wp-config.php" eine Reparatur der beschädigten WordPress-Datenbank durchführen. Zum Aufruf der Datei müssen Sie zunächst über ein FTP-Programm, wie z.B. File-Zilla, eine FTP-Verbindung zum Server aufbauen. Die Zugangsdaten erhalten Sie von Ihrem Hosting-Anbieter, sollten Ihnen diese nicht vorliegen. Sobald die FTP-Verbindung steht, finden Sie die Datei "wp-config.php" im Wurzelverzeichnis Ihrer Webseite. Laden Sie die Datei herunter und öffnen Sie diese anschließend mit einem Texteditor. Zur Aktivierung des Reparatur-Tools von WordPress fügen Sie folgende Codezeile vor der Zeile /** Absolute path to the WordPress directory. */ ein:

define( 'WP_ALLOW_REPAIR', true );

Hierbei sollten Sie unbedingt auf die richtige Schreibweise des Befehls achten. Besonders auf die Anführungszeichen und Leerzeichen im Befehl sollten Sie achten!

Speichern Sie im Anschluss die Datei und laden Sie diese wieder auf den Server hoch. Ersetzen Sie dabei die zuvor heruntergeladene Datei durch die neue Datei. Ist die Datei auf den Server hochgeladen, dann rufen Sie folgende Seite in Ihrem Browser auf: 

http://ihredomain.de/wp-admin/maint/repair.php --> Ersetzen Sie "ihredomain.de" durch Ihren Domainnamen!

Beim Aufruf der Seite wird das Reparatur-Tool von WordPress aufgerufen, worüber Sie die Datebank reparieren lassen oder eine Optimierung durchführen lassen können. Ist der Prozess abgeschlossen, sollten Sie das Tool unbedingt wieder deaktivieren, da ansonsten Dritte auf die Reparatur-URL zugreifen können. Öffnen Sie hierzu die Datei "wp-config.php" erneut und ändern Sie den Befehl define( 'WP_ALLOW_REPAIR', true ); auf define( 'WP_ALLOW_REPAIR', false); ab oder löschen Sie die Zeile einfach komplett. Vergessen Sie nicht, die geänderte Datei wieder auf den Server hochzuladen!

Was muss ich tun, wenn auch beim Aufruf des Adminbereichs die Fehlermeldung "Error establishing a database connection" erscheint?

Sollten Sie auch beim Aufruf des Adminbereichs die Fehlermeldung Error establishing a database connection erhalten, dann kann der Grund in einer fehlerhaften Angabe der Zugangsdaten in der Datei "wp-config.php" liegen. Aber wie kann es dazu kommen? Falls Sie kürzlich Ihren Webhostinganbieter gewechselt haben, dann haben sich ziemlich sicher auch die Zugangsdaten geändert. Des Weiteren kann der Fehler auch auftreten, wenn Sie kürzlich das Passwort für die Datenbank geändert haben und die Änderung nicht in den Einstellungen für WordPress übernommen wurden. Um dies zu überprüfen, öffnen Sie wieder die Datei "wp-config.php". Die folgenden Zeilen sind meist am Anfang des Quelltextes zu finden:

// ** MySQL settings ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'Der Name Ihrer Datenbank' );
/** MySQL database username */
define( 'DB_USER', 'Ihr Benutzername' );
/** MySQL database password */
define( 'DB_PASSWORD', 'Ihr Passwort' );
/** MySQL hostname */
define( 'DB_HOST', 'Der Name des Hosts Ihrer Datenbank' ); --> wird häufig als "localhost" bezeichnet

Gleichen Sie die eingetragenen Daten ganz genau mit den erhaltenen Daten Ihres Webhostingsanbieters ab, um auszuschließen, dass sich Rechtschreib- oder Zeichenfehler eingeschlichen haben. Häufig werden Zeichen falsch geschrieben oder verwechselt (Großes "O" mit null "0" verwechselt). Beim Passwort darf keine Leerzeichen enthalten sein. Auch sollte die Syntax überprüft und sichergestellt werden, dass diese korrekt ist. Wenn Sie den Fehler gefunden und die entsprechende Stelle korrigiert haben, laden Sie die korrekte Datei wieder auf den Server hoch.

Welche weiteren Verbindungsfehler können die Meldung "Error establishing a database connection" hervorrufen?

Der Fehler Error establishing a database connection kann auch auftreten, wenn die Datenbank gar nicht auf dem Server existiert oder auch der Datenbankserver nicht erreichbar ist. Sollte die Datenbank nicht existieren, dann ist klar, dass keine Verbindung aufgebaut werden kann und Sie diese Fehlermeldung erhalten. Sollten Sie Ihre Webseite kürzlich zu einem anderen Anbieter übertragen haben, dann kann es sein, dass der Datenbankimport fehlerhaft durchgeführt wurde und somit die notwendigen Tabellen nicht vorhanden oder fehlerhaft sind. Dies resultiert ebenfalls in dieser Fehlermeldung. Sollten Sie den Fehler nicht finden, ist es ratsam, den Datenbankimport nochmal neu durchzuführen.

Wie kann ich die Erreichbarkeit des Datenbank-Servers überprüfen?

Wenn Sie alle genannten Ursachen für die Fehlermeldung Error establishing a database connection ausgeschlossen haben, prüfen Sie, ob der Datenbankserver überhaupt erreichbar ist. Dies können Sie durch eine Verbindung über phpMyAdmin oder durch den Aufruf anderer Webseiten, die auf demselben Server liegen, testen. Falls Sie feststellen, dass der Server nicht erreichbar ist, liegt das Problem möglicherweise bei Ihrem Webhoster. Es könnte auch sein, dass die Fehlermeldung Error establishing a database connection aufgrund einer vorübergehenden Lastspitze des Servers auftritt. In diesem Fall sollte der Fehler innerhalb weniger Minuten wieder von alleine verschwinden. Sollte dieser Fall häufiger auftreten, raten wir Ihnen, sich mit Ihrem Hostinganbieter in Verbindung zu setzen, um eine Lösung zu finden.

Sind die Zugriffsrechte für die Datenbank korrekt eingestellt?

Ob die Zugriffsrechte für die Datenbank korrekt sind, können Sie mithilfe einer selbst erstellten PHP-Datei überprüfen. Erstellen Sie mit Hilfe des Texteditors eine neue Datei, z.B. verbindungstest.php, und laden Sie diese Datei via FTP hoch. In der Datei sollte ein passender Code, Ihr Datenbankpasswort und Ihr Datenbankbenutzernamen als Werte enthalten sein. Anschließend können Sie die Datei über Ihren Browser aufrufen, z.B. https://ihredomain.de/verbindungstest.php. Achten Sie darauf, dass Sie anstatt ihredomain.de Ihren tatsächlichen Domainnamen verwenden. Wenn Sie weiterhin keine Verbindung zur Datenbank herstellen können, kontaktieren Sie unbedingt Ihren Webhoster, da das Problem dann vermutlich bei ihm liegt und nicht von Ihnen behoben werden kann. 

Sollte der Aufruf funktionieren und eine Verbindung zur Datenbank hergestellt werden können, dann kann der Fehler nicht am Datenbanksystem liegen und Sie sollten nochmal die Angaben in der Datei "wp-config.php" überprüfen. Vergessen Sie nicht die Test-Datei nach der Überprüfung wieder zu löschen, da diese von Dritten aufgerufen werden kann.

Fazit

Die Fehlermeldung Error establishing a database connection bedeutet nicht zwangsläufig, dass Sie Ihre Webseite aufgeben oder neu erstellen müssen. Häufig ist ein kleiner Fehler in der Konfiguration dafür verantwortlich, der leicht behoben werden kann. Durch systematisches Ausschlussverfahren können Sie die genaue Ursache herausfinden und den Fehler beheben. Prüfen Sie besonders die Datei "wp-config.php" auf korrekte Einträge und seien Sie sorgfältig bei der Eingabe von Reparaturbefehlen.

FAQ - Häufig gestellte Fragen