WordPress Fehler beim Aufbau einer Datenbankverbindung

Wenn WordPress dir die Meldung „Fehler beim Aufbau einer Datenbankverbindung“ anzeigt, ist der Schreck erstmal riesig. Nur eine weiß-graue Seite mit der Fehlermeldung. Keine Website, keine Inhalte und kein Design. Die gute Nachricht: du musst dir keine großartigen Sorgen machen. Sobald der Fehler behoben ist, sind alle deine Inhalte direkt wieder da.

Und den Fehler beheben wir jetzt einfach mal gemeinsam.

Was bedeutet der WordPress „Fehler beim Aufbau einer Datenbankverbindung“?

„Fehler beim Aufbau einer Datenbankverbindung“ wird immer dann angezeigt, wenn WordPress nicht mit der Datenbank kommunizieren kann. In der Regel liegt das an fehlenden oder fehlerhaften Zugangsdaten für die Datenbank.

WordPress besteht aus zwei Komponenten: dem eigentlichen System und einer Datenbank, in der alle Texte und Einstellungen deiner Website gespeichert werden. Nur wenn beide Komponenten einwandfrei funktionieren, kann deine Website ordentlich angezeigt werden,

Wir dir ein „Fehler beim Aufbau einer Datenbankverbindung“ angezeigt, kann WordPress nicht mit deiner SQL-Datenbank kommunizieren. Deine Website kann also nicht angezeigt werden.

Wie du das Problem „Fehler beim Aufbau einer Datenbankverbindung“ beheben kannst

Es gibt eine ganze Reihe von Möglichkeiten, woher der Fehler kommen kann. Um dir nicht deine wertvolle Lebenszeit zu klauen, habe ich dir die folgenden Lösungen in der Reihenfolge der Wahrscheinlichkeit aufgelistet.

Mit etwas Glück ist deine Lösung gleich ganz oben mit dabei und du kannst 2 Euro in unsere Kaffeekasse stecken. 😉

1. Prüfe die Datenbank-Angaben in der wp-config.php

Diese Lösung kommt in erster Linie zum Tragen, wenn du dein WordPress gerade eben erst installierst, oder vor sehr kurzer Zeit an der wp-config.php Datei gearbeitet hast.

Die Datei wp-config.php gehört zu den wichtigsten Dateien in deiner WordPress Installation. Weil Sie alle wichtigen Angaben enthält, die WordPress zum Arbeiten braucht.

Datenbankeinstellungen in der wp-config.php Datei
Datenbankeinstellungen in der wp-config.php Datei

Ein spezieller Abschnitt in der wp-config.php enthält die Angaben, die WordPress mit deiner SQL-Datenbank verbinden:

  • den Datenbanknamen
  • den Server, auf dem deine Datenbank liegt (häufig Localhost)
  • deinen Benutzernamen für die Datenbank
  • das Kennwort deiner Datenbank

Sobald diese Angaben nicht eingetragen oder fehlerhaft sind, kann WordPress keine Verbindung mit der Datenbank aufbauen.

Du ahnst es schon: Das System spuckt die Meldung „Fehler beim Aufbau einer Datenbankverbindung“ aus. Alternativ auch „Error establishing a database connection“, wenn dein WordPress auf Englisch läuft.

Öffne die Datei wp-config.php per FTP mit einem Editor und prüfe, ob alle Angaben zur Verbindung mit der Datenbank korrekt eingetragen sind.

2. Verifiziere die Benutzerdaten der Datenbank

Heutzutage kannst du nahezu alle Einstellungen deines Hosting Pakets im Backend deines Hosters ändern. In der Regel kommt dafür ein so genanntes C-Panel zum Einsatz.

Auch die Einstellungen für deine Datenbanken können über das C-Panel leicht geändert werden. Das führt stellenweise dazu, dass die Einstellungen für die Datenbank im Hosting-Backend nicht mehr mit den Daten in deiner wp-config.php Datei übereinstimmen.

Wenn du den Fehler mit dem Aufbau der Datenbankverbindung nicht in der wp-config.php erkennen konntest, empfehle ich dir einen Blick in die Datenbankeinstellungen beim Hoster. Eventuell wurde hier etwas verändert, was zum Fehler führt.

Achte dabei ganz besonders auf diese 3 Punkte:

  • Name der Datenbank
  • Benutzername für die Datenbank
  • Kennwort für den Datenbankzugang

3. Setz dich mit deinem Hosting Anbieter in Verbindung

Dein Hosting Anbieter ist gleichzeitig auch derjenige, der die SQL-Datenbank hostet, die dein WordPress nutzt. In der Regel läuft die Datenbank auf einem anderen Server oder in einer anderen Instanz, als deine Website.

Das bedeutet, dass deine Website zwar theoretisch noch da, der Datenbank-Server aber aktuell nicht erreichbar ist.

Wenn du wie oben beschrieben, deine wp-config.php geprüft hast und dort alles in Ordnung ist, solltest du als nächstes deinen Hoster befragen. Eine kurze Nachricht an den Support reicht da völlig.

Erkläre, dass du Schwierigkeiten beim Aufbau der Datenbank-Verbindung hast und frage nach aktuellen Problemen mit dem Datenbank-Server.

Tipps, um die „Error establishing a database connection“ Meldung in Zukunft zu vermeiden

Die häufigste Ursache für den Fehler ist eigentlich eine falsch beschriebene wp-config-php. Ob das versehentlich passiert, oder ob dir jemand ganz bewusst Teile der Datei gelöscht hat, ist dabei nebensächlich.

In 98% aller Fälle, in denen ich mit dem fehlerhaften Aufbau der Datenbankverbindung zu tun hatte, lag die Lösung in genau dieser Konfigurationsdatei.

Um den Fehler in Zukunft zu vermeiden, empfehle ich dir regelmäßige Backups der kompletten Website und das Zurücksetzen der Schreibrechte (chmod) für die Datei wp-config-php. Das bedeutet, dass du über die Schreibrechte bestimmst, wer oder was Einträge in dieser Datei verändern kann.

Sehr häufig sehe ich, dass die Schreibrechte auf 755 stehen. Das bedeutet, dass ein nahezu vollständiger Zugriff auf die Datei für alles und jeden gegeben ist. Stellst du die Datei auf 660, bist du wesentlich sicherer unterwegs. Wie genau das ganz einfach mit einem FTP Programm funktioniert, erklärt dieser Artikel ziemlich gut.