Warum zeigt WordPress einen Fehler beim Aufbau einer Datenbankverbindung?

Wenn Ihre Website die Meldung „Error establishing a database connection“ (auf deutschen Installationen „Fehler beim Aufbau einer Datenbankverbindung“) anzeigt, läuft WordPress zwar, kann aber nicht mit der Datenbank kommunizieren, in der Ihre Inhalte gespeichert sind.

Jede Seite, jeder Beitrag, jedes Produkt, jede Bestellung, jeder Nutzer und jede Einstellung einer WordPress-Website liegt in dieser Datenbank. Wenn WordPress sie nicht erreicht, gibt es nichts anzuzeigen, und die gesamte Website bleibt meist bei dieser einen Textzeile stehen. Das Dashboard ist in der Regel ebenfalls betroffen.

Die Meldung wirkt ernst, und für eine geschäftliche Website ist sie das auch: Besucher sehen nichts Brauchbares, bis das Problem behoben ist. In den meisten Fällen bedeutet sie aber nicht, dass Ihre Daten gelöscht wurden. Meist ist die Datenbank vorübergehend nicht erreichbar oder überlastet, oder WordPress verwendet falsche Zugangsdaten für die Verbindung.

Dieser Leitfaden erklärt, was die Meldung bedeutet, welche Ursachen am häufigsten sind, was Sie gefahrlos prüfen können und wann es besser ist, technische Unterstützung anzufragen.

Was bedeutet dieser Fehler eigentlich?

Eine WordPress-Website besteht aus zwei Hauptteilen:

• den Dateien, also WordPress selbst, Plugins, Themes und hochgeladene Bilder
• der Datenbank, in der Inhalte und Einstellungen gespeichert sind

Wenn jemand eine Seite öffnet, liest WordPress eine Konfigurationsdatei namens wp-config.php, um herauszufinden, wo die Datenbank liegt und wie es sich dort anmeldet. Dann verbindet es sich mit dem Datenbankserver und fragt den Inhalt der Seite ab.

Der Fehler erscheint, wenn diese Verbindung fehlschlägt. WordPress weiß nicht genau, warum, und zeigt deshalb dieselbe allgemeine Meldung, ob der Datenbankserver ausgefallen ist, das Passwort falsch ist oder der Server einfach zu ausgelastet ist, um zu antworten.

Deshalb verrät die Meldung allein nicht, was das Problem verursacht hat. Sie sagt Ihnen, wo das Problem liegt, nicht, worin es besteht.

Sind meine Inhalte verloren?

Meist nicht.

In den meisten Fällen sind die Daten noch vorhanden. WordPress kann sie im Moment nur nicht erreichen. Sobald die Verbindung wiederhergestellt ist, erscheint die Website normalerweise genau so wie vorher.

Es gibt Ausnahmen, etwa einen ausgefallenen Server, eine gelöschte Datenbank oder schwere Beschädigungen. Diese sind seltener und ein weiterer Grund, überstürzte Maßnahmen zu vermeiden, etwa ein altes Backup wiederherzustellen oder WordPress neu zu installieren, bevor die Ursache bekannt ist.

Was sind die häufigsten Ursachen?

Der Datenbankserver ist ausgefallen oder überlastet

Bei den meisten Hosting-Tarifen läuft die Datenbank auf einem Server, den der Hosting-Anbieter verwaltet. Wenn dieser Server neu startet, gewartet wird oder überlastet ist, kann WordPress keine Verbindung herstellen.

Anzeichen, die in diese Richtung deuten:

• der Fehler trat plötzlich auf, ohne dass jemand an der Website etwas geändert hat
• er kommt und geht, besonders zu Stoßzeiten
• andere Websites im selben Hosting-Konto zeigen denselben Fehler
• der Hosting-Anbieter meldet eine Störung oder Wartungsarbeiten

Auch eine Traffic-Spitze, ein aggressiver Bot, ein umfangreicher Import oder ein fehlerhaftes Plugin können die Datenbank überlasten, sodass manche Anfragen fehlschlagen und andere funktionieren.

Die Verbindungsdaten in wp-config.php sind falsch

wp-config.php enthält vier Angaben, die WordPress für die Verbindung braucht:

• den Namen der Datenbank
• den Datenbanknutzer
• das Passwort dieses Nutzers
• den Datenbank-Host, also die Adresse des Datenbankservers

Wenn eine dieser Angaben falsch ist, schlägt die Verbindung fehl. Das passiert oft:

• nach einer Migration zu einem neuen Hosting-Anbieter oder Server
• nachdem das Datenbankpasswort im Hosting-Panel geändert wurde
• nachdem jemand eine alte Kopie von wp-config.php wiederhergestellt hat
• nachdem der Hosting-Anbieter die Datenbank auf einen anderen Server verlegt hat
• nachdem der Datenbanknutzer gelöscht wurde oder seine Berechtigungen verloren hat

Wenn der Fehler direkt nach einem dieser Ereignisse auftrat, ist das die wahrscheinlichste Ursache.

Die Datenbanktabellen sind beschädigt

Datenbanktabellen können beschädigt werden, etwa nach einem Serverabsturz, bei voller Festplatte oder durch einen unterbrochenen Vorgang. In diesem Fall stellt WordPress möglicherweise eine Verbindung her, kann aber nicht lesen, was es braucht.

Manchmal zeigt die öffentliche Website den Verbindungsfehler, während das Dashboard eine andere Meldung anzeigt, wonach die Datenbank repariert werden muss.

Das Hosting-Konto hat ein Limit erreicht

Hosting-Tarife haben oft Grenzen für:

• die Anzahl gleichzeitiger Datenbankverbindungen
• den Speicherplatz, den auch die Datenbank nutzt
• die Größe der Datenbank
• die Nutzung von CPU oder Arbeitsspeicher

Wenn eine Grenze erreicht ist, verweigert die Datenbank möglicherweise neue Verbindungen oder funktioniert nicht mehr richtig. Der Hosting-Anbieter kann das meist schnell bestätigen.

Das Konto wurde gesperrt

Wenn das Hosting-Konto gesperrt wurde, etwa wegen einer unbezahlten Rechnung, eines Verstoßes gegen Richtlinien oder eines Sicherheitsproblems, ist die Datenbank möglicherweise deaktiviert, während die Dateien online bleiben. Prüfen Sie, ob Sie E-Mails von Ihrem Hosting-Anbieter erhalten haben.

Was sollten Sie zuerst prüfen?

Sie müssen keine Dateien öffnen, um nützliche Informationen zu sammeln.

Prüfen Sie, ob der Fehler dauerhaft oder zeitweise auftritt

Laden Sie die Website über einige Minuten hinweg mehrmals neu, am besten in einem privaten oder Inkognito-Fenster.

• Wenn der Fehler immer da ist, ist ein Konfigurationsproblem oder eine vollständig ausgefallene Datenbank wahrscheinlicher.
• Wenn er kommt und geht, sind Überlastung oder Grenzen des Hostings wahrscheinlicher.

Prüfen Sie, ob sich etwas geändert hat

Überlegen Sie, was kurz vor dem Auftreten des Fehlers passiert ist:

• Wurde die Website migriert oder auf einen neuen Server verlegt?
• Hat jemand im Hosting-Panel ein Passwort geändert?
• Wurde ein Backup wiederhergestellt?
• Hat der Hosting-Anbieter Wartungsarbeiten angekündigt?
• Lief gerade ein großer Import, ein Newsletter oder eine Aktion?
• Hat jemand ein neues Plugin installiert?

Eine Notiz wie „der Fehler begann am Morgen, nachdem wir das Datenbankpasswort geändert hatten“ kann viel Zeit bei der Fehlersuche sparen.

Prüfen Sie andere Websites im selben Konto

Wenn Sie mehrere Websites beim selben Anbieter hosten, öffnen Sie sie. Wenn alle denselben Fehler zeigen, liegt das Problem sehr wahrscheinlich beim Hosting und nicht in Ihrer WordPress-Installation.

Prüfen Sie Status und E-Mails Ihres Hosting-Anbieters

Achten Sie auf:

• eine Statusseite oder Störungsmeldung Ihres Hosting-Anbieters
• E-Mails zu Wartungsarbeiten, Grenzen oder einer Sperrung
• Warnungen zum Speicherplatz im Hosting-Panel

Was können Sie gefahrlos ausprobieren?

Wenden Sie sich an Ihren Hosting-Anbieter

Bei diesem Fehler ist der Hosting-Anbieter oft die beste erste Anlaufstelle. Er kann meist kurzfristig bestätigen:

• ob der Datenbankserver läuft
• ob die Datenbank und ihr Nutzer noch existieren
• ob das Konto eine Grenze erreicht hat
• ob der Wert für den Datenbank-Host, den Sie verwenden sollten, korrekt ist
• ob es eine Störung oder Wartungsarbeiten gab

Fragen Sie klar: „Läuft der Datenbankserver für mein Konto, und sind Datenbankname, Nutzer und Host noch dieselben?“

Wenden Sie sich an die Person, die zuletzt an der Website gearbeitet hat

Wenn ein Entwickler, eine Agentur oder ein Kollege die Website kürzlich migriert, Hosting-Einstellungen geändert oder ein Backup wiederhergestellt hat, fragen Sie, was geändert wurde. Vielleicht weiß die Person sofort, welcher Wert korrigiert werden muss.

Warten Sie einige Minuten, wenn der Fehler zeitweise auftritt

Wenn der Hosting-Anbieter eine vorübergehende Überlastung oder Wartungsarbeiten bestätigt, kommt die Website möglicherweise von selbst zurück. Dann bleibt trotzdem eine Frage, die Sie später klären sollten: Warum war die Datenbank überlastet, und könnte das in einem wichtigen Moment für Ihr Geschäft wieder passieren?

Was sollten Sie vermeiden?

Wenn die Website ausgefallen ist, liegt es nahe, schnell mehrere Lösungen auszuprobieren. Vermeiden Sie:

• WordPress neu zu installieren
• ein Backup wiederherzustellen, bevor Sie die Ursache kennen, denn es kann neuere Bestellungen, Formulareinträge oder Inhalte überschreiben
• eine neue leere Datenbank anzulegen und WordPress darauf zu verweisen, wodurch die Website wie eine frische Installation aussieht
• den Datenbanknutzer zu löschen oder neu anzulegen, ohne die alten Angaben zu notieren
• wp-config.php zu bearbeiten, ohne vorher eine Kopie des Originals zu speichern
• beliebigen Code oder Einstellungen aus Foren zu übernehmen
• Reparatur-Tools wiederholt auszuführen, ohne zu verstehen, was sie tun

Wenn Sie nach einer Änderung statt Ihrer Website den Installationsbildschirm von WordPress sehen, hören Sie auf. Das bedeutet meist, dass WordPress mit einer leeren oder anderen Datenbank verbunden ist, nicht dass Ihre Inhalte weg sind. Schließen Sie die Installation nicht ab.

Wann sollten Sie technische Unterstützung anfragen?

Holen Sie sich Hilfe, wenn:

• der Fehler bestehen bleibt und der Hosting-Anbieter sagt, auf seiner Seite sei alles in Ordnung
• der Fehler nach einer Migration oder Wiederherstellung auftrat
• die Website Bestellungen, Buchungen, Abos oder Kundendaten verarbeitet
• der Fehler in Stoßzeiten immer wieder auftritt
• das Dashboard meldet, dass die Datenbank repariert werden muss
• Sie sich beim Bearbeiten von wp-config.php nicht sicher fühlen
• Sie nicht sicher sind, ob ein aktuelles Backup zuverlässig ist
• Sie vermuten, dass die Website kompromittiert worden sein könnte

Sie müssen die Ursache nicht vorher selbst ermitteln. Eine hilfreiche Anfrage kann einfach beschreiben, was Sie sehen, wann es begonnen hat und was sich geändert hat.

Welche Informationen sollten Sie sammeln?

Hilfreiche Angaben sind:

• die URL der Website
• ein Screenshot des Fehlers
• wann das Problem begonnen hat
• ob der Fehler dauerhaft oder zeitweise auftritt
• jede kürzliche Änderung, etwa eine Migration, eine Passwortänderung oder eine Wiederherstellung
• der Name des Hosting-Anbieters
• jede E-Mail oder Ticketantwort des Hosting-Anbieters
• ob andere Websites im selben Konto betroffen sind
• ob ein aktuelles Backup verfügbar ist

Senden Sie Datenbankpasswörter oder Hosting-Zugangsdaten nicht per gewöhnlicher E-Mail. D4Hub kann Ihnen sagen, welche Zugänge nötig sind und wie Sie sie sicher teilen.

Wie D4Hub helfen kann

Ziel ist nicht nur, den Fehler verschwinden zu lassen, sondern zu verstehen, warum die Verbindung fehlgeschlagen ist, und das Risiko einer Wiederholung zu verringern.

Je nach Situation unterstützt D4Hub Sie bei:

• der Prüfung der Verbindungsdaten, die WordPress für die Datenbank verwendet
• der Abstimmung mit Ihrem Hosting-Anbieter, um den Zustand des Datenbankservers zu bestätigen
• der Behebung von Konfigurationsproblemen nach einer Migration oder Passwortänderung
• der sicheren Prüfung und Reparatur beschädigter Datenbanktabellen
• der Untersuchung von Überlastung, langsamen Abfragen oder Plugins, die die Datenbank stark belasten
• der Prüfung von Hosting-Grenzen und der Empfehlung einer passenderen Einrichtung
• der Einschätzung, ob eine Wiederherstellung aus dem Backup nötig ist und welche Daten sie überschreiben könnte
• dem Testen von Login, Formularen, Checkout und anderen wichtigen Funktionen, sobald die Website wieder läuft

Sie können in jeder Phase Unterstützung anfragen, ob Sie den Fehler gerade erst gesehen, bereits mit Ihrem Hosting-Anbieter gesprochen oder schon eine Lösung versucht haben, die nicht funktioniert hat.

define( 'DB_NAME', 'database_name' );
define( 'DB_USER', 'database_user' );
define( 'DB_PASSWORD', 'database_password' );
define( 'DB_HOST', 'localhost' );

wp config get DB_NAME
wp config get DB_USER
wp config get DB_HOST

mysql -h localhost -u database_user -p database_name

SHOW TABLES;

wp db check

define( 'WP_ALLOW_REPAIR', true );

https://example.com/wp-admin/maint/repair.php

Häufig gestellte Fragen

Bedeutet dieser Fehler, dass meine Website gehackt wurde?

Meist nicht. Die häufigsten Ursachen sind Hosting-Probleme oder falsche Verbindungsdaten. Eine Kompromittierung ist möglich, etwa wenn jemand wp-config.php oder das Datenbankpasswort geändert hat, aber sie ist eine von mehreren Möglichkeiten. Wenn Ihnen auch unbekannte Nutzer, seltsame Weiterleitungen oder unerwartete Dateien auffallen, erwähnen Sie das, wenn Sie um Hilfe bitten.

Warum erscheint der Fehler nur manchmal?

Ein zeitweise auftretender Fehler bedeutet oft, dass der Datenbankserver überlastet ist oder das Konto an eine Verbindungsgrenze stößt. Traffic-Spitzen, Bots, ressourcenhungrige Plugins oder geplante Aufgaben können dazu beitragen. Der Hosting-Anbieter kann meist sehen, wann die Grenze erreicht wurde.

Ich habe das Datenbankpasswort geändert, und jetzt ist die Website nicht erreichbar. Was ist passiert?

WordPress hat in wp-config.php noch das alte Passwort. Das neue Passwort muss auch in die Zeile DB_PASSWORD eingetragen werden. Wenn Sie sich beim Bearbeiten der Datei nicht sicher fühlen, können Ihr Hosting-Anbieter oder D4Hub helfen.

Sollte ich ein Backup wiederherstellen?

Nicht als ersten Schritt. Wenn die Ursache eine falsche Einstellung oder ein Problem mit dem Datenbankserver ist, hilft eine Wiederherstellung nicht und kann neuere Bestellungen, Nachrichten oder Inhalte überschreiben. Eine Wiederherstellung ist erst sinnvoll, wenn die Ursache verstanden und das Backup geprüft ist.

Das Dashboard meldet, dass die Datenbank repariert werden muss. Ist das sicher?

Das eingebaute Reparatur-Tool ist genau dafür gedacht, aber erstellen Sie zuerst ein Backup der Datenbank und denken Sie daran, die Zeile WP_ALLOW_REPAIR danach zu entfernen. Wenn die Website Bestellungen oder Kundendaten verarbeitet, sollten Sie vor der Ausführung Unterstützung in Betracht ziehen.

Warum zeigt meine Website jetzt den Installationsbildschirm von WordPress?

Das bedeutet meist, dass WordPress mit einer Datenbank verbunden ist, die leer ist oder sich vom Original unterscheidet, oder dass das Tabellenpräfix in wp-config.php nicht zu den vorhandenen Tabellen passt. Schließen Sie die Installation nicht ab. Prüfen Sie den Datenbanknamen und das Tabellenpräfix oder holen Sie sich Hilfe.

Kann D4Hub helfen, wenn der Hosting-Anbieter sagt, alles sei in Ordnung?

Ja. Teilen Sie uns mit, was der Hosting-Anbieter gesagt hat und was Sie bereits versucht haben. D4Hub kann die Konfiguration, die Datenbank und die Website selbst prüfen, um herauszufinden, wo die Verbindung fehlschlägt.