„Fehler beim Aufbau einer Datenbankverbindung": die vier Ursachen und wie Sie sie prüfen

Die Meldung „Fehler beim Aufbau einer Datenbankverbindung” (englisch „Error establishing a database connection”) ist eine der wenigen WordPress-Meldungen, die wörtlich zu nehmen ist: Der PHP-Code läuft, aber er bekommt keine Verbindung zur MySQL- oder MariaDB-Datenbank, in der alle Inhalte liegen. Ohne Datenbank gibt es keine Seite, deshalb bricht WordPress an dieser Stelle komplett ab — Frontend und Backend gleichermaßen.

Es gibt genau vier Ursachen. In dieser Reihenfolge prüfen:

1. Der Datenbankserver ist weg

Die häufigste Ursache bei Seiten, die gestern noch liefen und an denen niemand etwas geändert hat. Der Datenbankserver des Hosters ist überlastet, wird gerade gewartet oder ist abgestürzt. Prüfen: Statusseite des Hosters aufrufen (IONOS, Strato, all-inkl und die meisten anderen haben eine), oder einfach zehn Minuten warten und neu laden. Bei Shared Hosting ist das Problem oft nach einer Viertelstunde von selbst vorbei.

Ist es nicht vorbei, hilft ein kleiner Test: Legen Sie per FTP eine Datei dbtest.php ins Hauptverzeichnis mit diesem Inhalt (Werte aus wp-config.php übernehmen):

<?php
$db = @mysqli_connect('DB_HOST', 'DB_USER', 'DB_PASSWORD', 'DB_NAME');
echo $db ? 'Verbindung steht.' : 'Fehler: ' . mysqli_connect_error();

Rufen Sie ihre-domain.de/dbtest.php auf. Die Antwort sagt, ob der Server erreichbar ist und wenn nicht, warum. Datei danach unbedingt löschen — sie enthält Ihre Zugangsdaten.

2. Die Zugangsdaten stimmen nicht

Typisch nach einem Umzug, einem Hoster-Wechsel oder einer Passwortänderung im Kundenmenü. WordPress liest Datenbankname, Benutzer, Passwort und Host aus wp-config.php:

define( 'DB_NAME', 'dbs123456' );
define( 'DB_USER', 'dbu123456' );
define( 'DB_PASSWORD', '...' );
define( 'DB_HOST', 'db5001234.hosting-data.io' );

Vergleichen Sie die vier Werte mit dem, was im Kundenmenü des Hosters unter „Datenbanken” steht. Zwei Fallen: DB_HOST ist nicht immer localhost — bei IONOS, Strato und vielen anderen ist es ein eigener Hostname. Und wer das Datenbankpasswort im Hoster-Menü „zurückgesetzt” hat, um es nachzuschlagen, hat es damit geändert, und die alte Angabe in wp-config.php ist ungültig.

3. Eine Tabelle ist beschädigt

Dann erreicht WordPress die Datenbank zwar, aber eine der Tabellen ist unbrauchbar — meist nach einem vollen Datenträger oder einem Absturz mitten in einem Schreibvorgang. Das Frontend zeigt dann oft den Datenbankfehler, das Backend dagegen eine andere Meldung („Eine oder mehrere Datenbanktabellen sind nicht verfügbar”). WordPress bringt ein Reparaturwerkzeug mit: In wp-config.php die Zeile define( 'WP_ALLOW_REPAIR', true ); ergänzen, dann ihre-domain.de/wp-admin/maint/repair.php aufrufen und „Datenbank reparieren” wählen. Die Zeile hinterher wieder entfernen — die Seite ist sonst ohne Login für jeden aufrufbar.

4. Der Hoster drosselt

Bei günstigen Tarifen ist die Zahl gleichzeitiger Datenbankverbindungen begrenzt. Ein Besucheransturm, ein Bot, der jede Seite zehnmal pro Sekunde abruft, oder ein Plugin, das bei jedem Aufruf Dutzende Abfragen stellt, füllt das Kontingent. Die Seite zeigt dann minutenweise den Fehler und läuft dazwischen normal. Erkennbar im Fehlerprotokoll an „Too many connections”. Die Lösung ist selten „größerer Tarif”, sondern meist Caching, das die Datenbank entlastet — unser Beitrag zu WP Rocket erklärt, wie.

Wenn nichts davon zutrifft

Dann liegt es meist an etwas, das erst bei genauem Hinsehen auffällt: ein Sicherheits-Plugin, das die eigene Datenbankverbindung blockiert, eine Firewall-Regel des Hosters, eine zerschossene wp-config.php nach einem Umzug, bei dem die Kodierung umgestellt wurde. Das ist die Art Fehler, für die es unsere WordPress-Soforthilfe gibt: eine Stunde konzentrierte Fehlersuche für 99 €, Start am selben Werktag, mit Backup vor jedem Eingriff. Ein Datenbankfehler ist in dieser Stunde fast immer gefunden und behoben — und Sie bekommen hinterher aufgeschrieben, was es war.