Zum Hauptinhalt springen

Fehler beim Aufbau einer Datenbankverbindung – WordPress reparieren

Sie öffnen Ihre Website und statt Ihrer Inhalte erscheint nur eine weiße Seite mit der Meldung „Fehler beim Aufbau einer Datenbankverbindung“ – oder auf Englisch „Error establishing a database connection“. Ihre Website ist komplett down. Keine Startseite, kein Dashboard, nichts.

Dieser Fehler ist einer der häufigsten WordPress-Probleme überhaupt. Er bedeutet, dass WordPress keine Verbindung zur MySQL-Datenbank herstellen kann – und ohne Datenbank funktioniert nichts, denn dort liegen alle Ihre Inhalte, Einstellungen und Benutzerdaten.

Die gute Nachricht: In den meisten Fällen lässt sich das Problem beheben, ohne dass Daten verloren gehen.

Ursache 1: Falsche Zugangsdaten in der wp-config.php

Das ist die mit Abstand häufigste Ursache. In der Datei wp-config.php stehen die Zugangsdaten für die Datenbank. Wenn dort ein falscher Datenbankname, Benutzername, Passwort oder Server eingetragen ist, kann WordPress keine Verbindung aufbauen.

Wann passiert das? Oft nach einem Umzug zu einem neuen Hoster, nach Änderungen am Hosting-Paket, wenn der Hoster die Datenbank-Server umstrukturiert oder wenn jemand versehentlich die Datei bearbeitet hat.

So prüfen Sie es: Verbinden Sie sich per FTP mit Ihrem Webspace und öffnen Sie die wp-config.php. Dort finden Sie vier relevante Zeilen:

define('DB_NAME', 'ihre_datenbank');
define('DB_USER', 'ihr_benutzername');
define('DB_PASSWORD', 'ihr_passwort');
define('DB_HOST', 'localhost');

Vergleichen Sie diese Werte mit den Datenbank-Zugangsdaten in Ihrem Hosting-Dashboard. Besonders der DB_HOST ist tückisch – bei manchen Hostern heißt er nicht „localhost“, sondern hat eine eigene Adresse.

Ursache 2: Der Datenbankserver ist nicht erreichbar

Manchmal liegt das Problem nicht bei Ihrer Website, sondern beim Datenbankserver Ihres Hosters. Das erkennen Sie daran, dass die Fehlermeldung plötzlich auftaucht, ohne dass Sie irgendetwas geändert haben.

Prüfen Sie zuerst die Statusseite Ihres Hosting-Anbieters nach aktuellen Störungen. Kontaktieren Sie den Support und fragen Sie gezielt: „Ist der MySQL-Datenbankserver erreichbar?“

In diesem Fall können Sie nur warten. Der Hoster muss das Problem auf seiner Seite beheben. Bei guten Hostern dauert das Minuten, bei schlechteren kann es Stunden dauern.

Ursache 3: Die Datenbank ist beschädigt

Eine beschädigte Datenbank kann verschiedene Ursachen haben – ein Serverabsturz während eines Schreibvorgangs, zu wenig Speicherplatz oder ein abgebrochenes Plugin-Update.

WordPress bietet eine eingebaute Reparaturfunktion. Fügen Sie folgende Zeile in Ihre wp-config.php ein:

define('WP_ALLOW_REPAIR', true);

Rufen Sie dann www.ihre-domain.de/wp-admin/maint/repair.php auf. Dort haben Sie zwei Optionen: „Datenbank reparieren“ und „Datenbank reparieren und optimieren“.

Wichtig: Entfernen Sie die Zeile unbedingt wieder aus der wp-config.php, sobald die Reparatur abgeschlossen ist. Diese Seite ist ohne Login erreichbar.

Ursache 4: Speicherlimit erreicht

WordPress und seine Plugins brauchen Arbeitsspeicher. Wenn das PHP Memory Limit zu niedrig gesetzt ist, kann die Datenbankverbindung fehlschlagen – besonders bei größeren Websites mit vielen Plugins.

Sie können das Memory Limit erhöhen:

define('WP_MEMORY_LIMIT', '256M');

Nicht jeder Hoster erlaubt diese Anpassung. Wenn die Änderung keine Wirkung zeigt, kontaktieren Sie Ihren Hoster und fragen Sie nach dem maximal verfügbaren PHP Memory Limit.

Ursache 5: Zu viele gleichzeitige Verbindungen

Wenn Ihre Website plötzlich viel Traffic bekommt oder ein Bot Ihre Seite aggressiv crawlt, kann die maximale Anzahl gleichzeitiger Datenbankverbindungen überschritten werden. Das ist besonders bei günstigen Shared-Hosting-Paketen ein Problem.

Anzeichen: Der Fehler tritt nur sporadisch auf, oder vor allem zu bestimmten Uhrzeiten, wenn der Server unter Last steht.

Kurzfristige Lösung: Caching-Plugin installieren (z.B. WP Super Cache), damit nicht bei jedem Seitenaufruf eine Datenbankabfrage nötig ist. Langfristige Lösung: Wechseln Sie auf ein besseres Hosting-Paket oder einen Managed-WordPress-Hoster.

Sonderfall: Gehackte Website

Ein oft übersehener Grund für Datenbankfehler: Ihre Website wurde gehackt. Manche Malware manipuliert die wp-config.php oder die Datenbank direkt. Wenn keine der oben genannten Ursachen zutrifft und der Fehler plötzlich auftritt, sollten Sie einen Hack nicht ausschließen.

In meinem Beitrag WordPress gehackt – was tun? erkläre ich, wie Sie einen Hack erkennen und was dann zu tun ist.

Vorbeugen ist besser als reparieren

Datenbank-Fehler treten seltener auf, wenn Ihre Website regelmäßig gewartet wird. Dazu gehören tägliche Backups, regelmäßige Updates und ein Monitoring, das Sie sofort informiert, wenn Ihre Seite nicht mehr erreichbar ist.

All das ist Teil meiner WordPress-Wartungsverträge. Sie müssen sich um nichts kümmern – ich behalte Ihre Website im Blick.

Das Problem besteht noch?

Wenn Sie den Fehler nicht selbst beheben können oder unsicher sind, wo die Ursache liegt: Ich helfe Ihnen gerne. In den meisten Fällen kann ich das Problem innerhalb weniger Stunden identifizieren und beheben – zum Festpreis, ohne versteckte Kosten.