„Fehler beim Aufbau einer Datenbankverbindung“ in WordPress beheben

Kurz gesagt: „Fehler beim Aufbau einer Datenbankverbindung“ heißt: WordPress erreicht seine MySQL-Datenbank nicht. Meistens stimmen die Zugangsdaten in der wp-config.php nicht mehr, etwa nach einem Hosterwechsel oder einer Passwortänderung. Andere Ursachen sind ein überlasteter oder ausgefallener Datenbankserver und beschädigte Tabellen. Mit einer kleinen Testdatei finden Sie in wenigen Minuten heraus, welcher Fall vorliegt.

Auf englischen Installationen lautet die Meldung „Error establishing a database connection“. Sie erscheint auf jeder Seite, oft auch unter /wp-admin. Für Besucher sieht das nach einer kaputten Website aus. In Wirklichkeit sind die Inhalte in den meisten Fällen unversehrt, denn sie liegen in der Datenbank. WordPress kommt nur gerade nicht an sie heran.

Wie WordPress mit der Datenbank spricht

Alle Seiten, Beiträge, Einstellungen und Benutzer liegen in einer MySQL- oder MariaDB-Datenbank. Bei jedem Seitenaufruf meldet sich WordPress dort mit vier Angaben an, die in der Datei wp-config.php im Hauptverzeichnis stehen:

define( 'DB_NAME', 'name_der_datenbank' );
define( 'DB_USER', 'benutzername' );
define( 'DB_PASSWORD', 'passwort' );
define( 'DB_HOST', 'localhost' );

Klappt diese Anmeldung nicht, bricht WordPress sofort ab und zeigt die Fehlermeldung. Es gibt also genau zwei Möglichkeiten: Entweder sind die Angaben falsch, oder der Datenbankserver antwortet nicht.

Die häufigsten Ursachen

1. Falsche oder geänderte Zugangsdaten

Das ist der häufigste Fall. Jemand hat im Kundenmenü des Hosters das Datenbank-Passwort geändert, oft aus Sicherheitsgründen und ohne an WordPress zu denken. Oder die Website ist zu einem anderen Hoster umgezogen und die wp-config.php enthält noch die alten Daten.

2. Falscher Datenbank-Host

Viele Hoster verwenden localhost, andere einen eigenen Datenbankserver mit Namen wie rdbms.strato.de bei Strato oder db….hosting-data.io bei IONOS. Wer eine Website umzieht und DB_HOST nicht anpasst, bekommt genau diese Meldung. Welcher Wert richtig ist, steht im Kundenmenü bei der Datenbank.

3. Datenbankserver überlastet oder ausgefallen

Tritt der Fehler nur zeitweise auf, ist der Datenbankserver vermutlich überlastet. Typische Auslöser sind plötzlich viele Besucher, aggressive Bots oder ein Plugin, das bei jedem Aufruf aufwendige Abfragen stellt. Auf günstigen Shared-Hosting-Paketen ist die Zahl gleichzeitiger Verbindungen begrenzt. Manchmal hat auch einfach der Hoster eine Störung. Ein Blick auf dessen Statusseite spart dann viel Sucherei.

4. Beschädigte Tabellen

Nach einem Serverabsturz oder einem abgebrochenen Import können Tabellen beschädigt sein. Dann zeigt das Backend oft einen etwas anderen Hinweis: dass eine oder mehrere Datenbanktabellen nicht verfügbar sind und die Datenbank repariert werden muss.

5. Datenbank gelöscht oder Speicher voll

Selten, aber es kommt vor: Das Hosting-Paket wurde gekündigt oder nicht bezahlt und die Datenbank entfernt. Oder das Speicherlimit der Datenbank ist erreicht. Beides sehen Sie im Kundenmenü.

Schritt 1: Die Zugangsdaten vergleichen

Öffnen Sie per FTP oder im Dateimanager des Hosters die wp-config.php und vergleichen Sie die vier Werte mit den Angaben im Kundenmenü unter „Datenbanken“ oder „MySQL“. Achten Sie auf Leerzeichen, vertauschte Buchstaben und das Hochkomma am Ende. Das Passwort zeigt Ihnen der Hoster meist nicht an. Sie können es dort aber neu setzen und anschließend in die wp-config.php eintragen.

Schicken Sie die wp-config.php nie per E-Mail oder Chat an Personen, die Sie nicht beauftragt haben. Sie enthält das Passwort zu allen Daten Ihrer Website.

Schritt 2: Die Verbindung gezielt testen

Ob die Daten stimmen, finden Sie mit einer kleinen Testdatei heraus. Legen Sie im Hauptverzeichnis eine Datei mit einem zufälligen Namen an, etwa dbtest-7f3k.php, und tragen Sie die Werte aus der wp-config.php ein:

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
try {
    new mysqli('localhost', 'benutzername', 'passwort', 'name_der_datenbank');
    echo 'Verbindung OK';
} catch (mysqli_sql_exception $e) {
    echo 'Fehler: ' . $e->getMessage();
}

Rufen Sie die Datei im Browser auf. Die Antwort grenzt das Problem ein:

• „Verbindung OK“: Die Daten sind richtig. Dann liegt es an der wp-config.php selbst, etwa an einem Tippfehler, oder an beschädigten Tabellen.
• „Access denied for user“: Benutzername oder Passwort stimmen nicht, oder der Benutzer hat keine Rechte auf diese Datenbank.
• „Unknown database“: Der Datenbankname ist falsch, oder die Datenbank existiert nicht mehr.
• „Connection refused“, „No such file or directory“ oder „getaddrinfo failed“: Der Host ist falsch, oder der Datenbankserver läuft nicht.
• „Too many connections“: Der Server ist überlastet.

Löschen Sie die Testdatei danach sofort. Sie enthält Ihr Datenbank-Passwort im Klartext.

Schritt 3: Beschädigte Tabellen reparieren

Stimmt die Verbindung, aber WordPress meldet weiter Fehler, hat WordPress eine eingebaute Reparaturfunktion. Fügen Sie in der wp-config.php oberhalb der Zeile /* That's all, stop editing! */ ein (in deutschen Installationen heißt sie „Das war’s, Schluss mit dem Bearbeiten!“):

define( 'WP_ALLOW_REPAIR', true );

Rufen Sie dann https://ihre-domain.de/wp-admin/maint/repair.php auf und wählen Sie „Datenbank reparieren“. Wichtig: Diese Seite ist ohne Anmeldung erreichbar. Entfernen Sie die Zeile direkt nach der Reparatur wieder.

Ist die Datenbank groß oder ein Shop betroffen, sichern Sie sie vorher über phpMyAdmin im Kundenmenü. Eine Reparatur ist meistens harmlos, aber nicht immer.

Wenn der Fehler nur manchmal auftritt

Kommt und geht die Meldung, ist fast immer Last das Problem, nicht die Zugangsdaten. Prüfen Sie in der Statistik des Hosters oder in den Zugriffsprotokollen, ob der Fehler mit Besucherspitzen oder auffällig vielen Aufrufen einzelner Bots zusammenfällt. Ein Seiten-Cache entlastet die Datenbank deutlich. Plugins, die bei jedem Aufruf Statistiken schreiben oder große Abfragen stellen, sind häufige Kandidaten. Reicht das nicht, ist das Hosting-Paket schlicht zu klein für die Website.

Wann Sie Hilfe holen sollten

Wenn die Zugangsdaten stimmen und der Fehler trotzdem bleibt, wenn die Reparatur selbst Fehler meldet, wenn ein Shop mit Bestellungen betroffen ist oder wenn die Website gerade umgezogen wurde und noch weitere Dinge nicht funktionieren. Ein falscher Schritt in der Datenbank lässt sich ohne Sicherung nicht rückgängig machen.

Professionelle Hilfe

Ich prüfe Zugangsdaten, Datenbankserver und Tabellen, behebe die Ursache und sorge dafür, dass der Fehler bei der nächsten Besucherspitze nicht wiederkommt. Die WordPress-Reparatur beginnt bei 290 € netto, die Fehler-Analyse kostet 150 € netto. Tritt der Fehler nach einem Hosterwechsel auf, hilft der Website-Umzug, bei dem auch Datenbank, E-Mails und Domain sauber mitkommen.