WordPress: Fehler beim Aufbau einer Datenbankverbindung

Die Seite lädt, aber statt Ihrer Startseite steht dort nur ein einziger Satz auf weißem Grund. Kein Menü, kein Login, nichts. Auf englischsprachigen Installationen heißt die Meldung „Error establishing a database connection“.

Das sieht dramatischer aus, als es meistens ist. WordPress besteht aus zwei Teilen: den Dateien auf dem Webspace und einer Datenbank, in der alle Inhalte liegen. Die Meldung sagt nur, dass die Verbindung zwischen beiden gerade nicht zustande kommt. Die Daten selbst sind davon zunächst nicht betroffen.

Dieser Ratgeber geht die Prüfung in der Reihenfolge durch, in der ein Techniker sie gehen würde – vom harmlosesten zum aufwendigsten Fall.

Was Sie zuerst nicht tun sollten

Bevor es um die Lösung geht, drei Dinge, die den Schaden größer machen:

WordPress nicht neu installieren. Eine Neuinstallation legt im ungünstigsten Fall eine neue, leere Datenbank an oder überschreibt Ihre wp-config.php. Dann suchen Sie anschließend zwei Probleme statt einem.
Keine neue Datenbank anlegen und die Zugangsdaten darauf umbiegen. Die Fehlermeldung verschwindet dann zwar, aber WordPress startet leer – als hätte es Ihre Website nie gegeben.
Kein Backup einspielen, solange die Ursache unklar ist. Liegt das Problem beim Hoster, ändert ein Backup nichts. Es überschreibt aber alles, was seit der Sicherung dazugekommen ist: Bestellungen, Anfragen, Beiträge.

Schritt 1: Ist nur Ihre Seite betroffen?

Rufen Sie zuerst die Statusseite oder die Störungsmeldungen Ihres Hosters auf. Ein Ausfall des Datenbankservers trifft meist viele Kunden gleichzeitig und ist dort vermerkt. Dann ist Abwarten die richtige Maßnahme – Sie können an Ihrer Seite nichts reparieren, was auf dem Server des Hosters kaputt ist.

Achten Sie außerdem darauf, ob der Fehler dauerhaft oder nur zeitweise auftritt. Kommt die Seite nach einem Neuladen mal und mal nicht, spricht das fast immer für einen überlasteten Datenbankserver oder ein erreichtes Verbindungslimit, nicht für falsche Zugangsdaten.

Schritt 2: Was hat sich zuletzt geändert?

Wie bei fast jedem WordPress-Fehler steht ein großer Teil der Antwort in dieser Frage:

Wurde die Website umgezogen – zu einem anderen Hoster, auf eine neue Domain oder in einen anderen Tarif?
Wurde das Datenbankpasswort geändert, etwa im Rahmen einer Sicherheitsmaßnahme oder vom Hoster?
Hat jemand die wp-config.php bearbeitet?
Gab es eine Mitteilung des Hosters über Wartungsarbeiten oder einen Serverwechsel?

Ein Umzug oder ein neues Passwort erklärt die Meldung fast immer vollständig.

Schritt 3: Sichern

Bevor Sie Dateien bearbeiten, laden Sie per FTP oder über den Dateimanager des Hosters mindestens die Datei wp-config.php herunter. Bietet Ihr Hoster eine Sicherung der Datenbank im Kundenbereich an, erstellen Sie auch diese. Falls die Datenbank gerade nicht erreichbar ist, geht das nicht – dann sichern Sie zumindest die Dateien.

Schritt 4: Zugangsdaten in der wp-config.php prüfen

Die Datei wp-config.php liegt im Hauptverzeichnis Ihrer WordPress-Installation, also im selben Ordner wie wp-admin und wp-content. Darin stehen vier Einträge, die zusammenpassen müssen:

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

Vergleichen Sie jeden Wert Zeichen für Zeichen mit den Angaben im Kundenbereich Ihres Hosters unter „Datenbanken“ oder „MySQL“. Typische Stolperstellen:

DB_HOST: Nicht jeder Hoster verwendet localhost. Viele nutzen einen eigenen Servernamen, manchmal mit Portangabe hinter einem Doppelpunkt. Nach einem Umzug steht hier oft noch der Wert des alten Hosters.
Leerzeichen und Anführungszeichen: Ein versehentliches Leerzeichen innerhalb der Hochkommas macht den Wert ungültig. Bearbeiten Sie die Datei nur mit einem reinen Texteditor, nie mit einem Textverarbeitungsprogramm, das gerade Anführungszeichen in typografische umwandelt.
Passwort: Wird es beim Hoster nicht angezeigt, setzen Sie dort ein neues und tragen genau dieses in die wp-config.php ein.

Ändern Sie dabei nicht den Eintrag $table_prefix. Er legt fest, wie die Tabellen Ihrer Installation heißen. Ein falscher Wert führt dazu, dass WordPress eine leere Installation vermutet und den Einrichtungsassistenten startet.

Schritt 5: Die Zugangsdaten unabhängig testen

Der einfachste Gegentest für Laien: Melden Sie sich mit genau denselben Daten in phpMyAdmin an, das fast jeder Hoster im Kundenbereich anbietet.

Die Anmeldung klappt und Sie sehen Tabellen mit Namen wie wp_posts oder wp_options? Dann sind Datenbank und Zugangsdaten in Ordnung, und das Problem liegt in der wp-config.php selbst – meist ein Tippfehler oder ein falscher DB_HOST.
Die Anmeldung schlägt fehl, obwohl die Daten stimmen? Dann liegt das Problem beim Datenbankbenutzer oder beim Datenbankserver. Das ist ein Fall für den Hoster.
Die Anmeldung klappt, aber die Datenbank ist leer? Dann zeigt Ihre wp-config.php auf die falsche Datenbank. Prüfen Sie, ob es beim Hoster mehrere Datenbanken gibt, und welche davon Ihre Tabellen enthält.

Schritt 6: Beschädigte Tabellen reparieren

Zeigt WordPress im Backend den Hinweis, dass eine oder mehrere Tabellen nicht verfügbar sind und die Datenbank repariert werden muss, erreicht WordPress die Datenbank zwar – einzelne Tabellen sind aber beschädigt. Das kann etwa nach einem Serverabsturz oder einem abgebrochenen Schreibvorgang passieren.

WordPress bringt dafür ein eigenes Werkzeug mit. Tragen Sie in der wp-config.php oberhalb von /* That's all, stop editing! */ diese Zeile ein:

define( 'WP_ALLOW_REPAIR', true );

Rufen Sie danach ihre-domain.de/wp-admin/maint/repair.php auf und starten Sie die Reparatur. Entfernen Sie die Zeile sofort danach wieder. Die Reparaturseite ist ohne Anmeldung erreichbar, solange die Einstellung aktiv ist.

Alternativ lassen sich einzelne Tabellen auch in phpMyAdmin markieren und über „Tabelle reparieren“ bearbeiten.

Schritt 7: Wenn der Datenbankserver das Problem ist

Stimmen die Zugangsdaten, und der Fehler tritt trotzdem auf, liegen die Ursachen auf der Serverseite:

Zu viele gleichzeitige Verbindungen. Viele Tarife begrenzen, wie viele Verbindungen ein Datenbankbenutzer gleichzeitig öffnen darf. Bei viel Besucherverkehr, bei Bot-Angriffen auf die Anmeldeseite oder bei Plugins, die die Datenbank stark beanspruchen, wird diese Grenze erreicht.
Voller Speicherplatz. Ist das Kontingent des Webspaces oder der Datenbank ausgeschöpft, kann der Datenbankserver nicht mehr schreiben.
Ausfall oder Wartung des Datenbankservers.

Schildern Sie dem Hoster in diesem Fall genau, was Sie geprüft haben: dass die Zugangsdaten stimmen, ob die Anmeldung in phpMyAdmin funktioniert, und ob der Fehler dauerhaft oder zeitweise auftritt. Das verkürzt die Bearbeitung erheblich.

Wenn ein Angriff dahintersteckt

Selten, aber möglich: Eine manipulierte wp-config.php. Fallen Ihnen darin Zeilen auf, die Sie nicht kennen – lange, unlesbare Zeichenketten, eval( oder base64_decode( –, behandeln Sie die Seite als kompromittiert. Dann gilt eine andere Reihenfolge, beschrieben unter Erste Hilfe, wenn die Website gehackt wurde.

Sehen Sie statt der Datenbankmeldung einen weißen Bildschirm oder „Auf der Website ist ein kritischer Fehler aufgetreten“, ist das ein anderes Problem. Die passende Anleitung steht unter kritischer Fehler / weißer Bildschirm.

Umsetzungsplan

Arbeiten Sie die Punkte in dieser Reihenfolge ab.

Sofort

Statusseite des Hosters prüfen – liegt eine bekannte Störung vor, abwarten.
Festhalten, ob der Fehler dauerhaft oder nur zeitweise auftritt.
Klären, was sich zuletzt geändert hat: Umzug, neues Passwort, bearbeitete Dateien.

Danach

wp-config.php per FTP herunterladen und sichern.
DB_NAME, DB_USER, DB_PASSWORD und DB_HOST mit den Angaben im Kundenbereich des Hosters vergleichen und korrigieren.
Mit denselben Daten in phpMyAdmin anmelden und prüfen, ob die WordPress-Tabellen vorhanden sind.
Bei Hinweis auf beschädigte Tabellen: WP_ALLOW_REPAIR setzen, reparieren, Zeile wieder entfernen.
Bleibt der Fehler trotz korrekter Daten: Hoster mit den Prüfergebnissen kontaktieren.

Vorbeugen

Zugangsdaten nach jedem Umzug und jeder Passwortänderung sofort in der wp-config.php nachziehen.
Regelmäßige, automatische Sicherungen von Dateien und Datenbank einrichten – getrennt vom Webspace gespeichert.
Die Anmeldeseite gegen massenhafte Login-Versuche schützen, damit Bots die Datenbank nicht überlasten.
Einen Tarif wählen, der zur Besucherzahl passt. Bei Managed Hosting übernehmen wir Überwachung, Sicherungen und Updates.

Wir beheben das für Sie

Wenn die Zugangsdaten stimmen und die Seite trotzdem nicht lädt, oder wenn Sie die wp-config.php lieber nicht selbst anfassen möchten: Wir übernehmen die Diagnose und sagen Ihnen vorher verbindlich, was die Reparatur kostet. Läuft Ihre Seite nicht mit WordPress, finden Sie die passende Hilfe unter Website-Fehler beheben.

Wir beheben das für Sie
Schildern Sie kurz, was passiert ist – wir melden uns schnellstmöglich zurück.

Fehler beheben lassen → Notfall-Diagnose für 99 €

Die WordPress-Notfall-Diagnose kostet 99 € und umfasst die Sicherung, das Auslesen der Fehlerprotokolle und ein Festpreis-Angebot für die Reparatur – bei Beauftragung werden die 99 € angerechnet. Oder rufen Sie direkt an: 0 33 41 - 35 66 146.

Häufige Fragen

Was bedeutet „Fehler beim Aufbau einer Datenbankverbindung“?

WordPress speichert Beiträge, Seiten, Einstellungen und Benutzer in einer MySQL- oder MariaDB-Datenbank. Bei jedem Seitenaufruf baut WordPress eine Verbindung zu dieser Datenbank auf. Gelingt das nicht, erscheint diese Meldung. Ihre Inhalte sind dadurch in aller Regel nicht verloren – WordPress kommt nur gerade nicht an sie heran.

Sind meine Daten weg?

Meistens nicht. Die häufigsten Ursachen sind falsche oder geänderte Zugangsdaten in der wp-config.php, ein überlasteter oder ausgefallener Datenbankserver beim Hoster oder beschädigte Tabellen. In all diesen Fällen liegen die Daten weiterhin in der Datenbank. Gefährlich wird es erst, wenn man in der Aufregung eine neue, leere Datenbank anlegt oder WordPress neu installiert.

Wo finde ich die richtigen Zugangsdaten für die Datenbank?

Im Kundenbereich Ihres Hosters, meist unter einem Punkt wie Datenbanken oder MySQL. Dort stehen Datenbankname, Benutzername und der Datenbank-Host. Das Passwort wird oft nicht angezeigt, lässt sich dort aber neu setzen. Diese Werte müssen exakt mit den Einträgen DB_NAME, DB_USER, DB_PASSWORD und DB_HOST in der Datei wp-config.php übereinstimmen.

Was mache ich, wenn WordPress sagt, die Datenbank müsse repariert werden?

Dann erreicht WordPress die Datenbank zwar, einzelne Tabellen sind aber beschädigt. Erstellen Sie zuerst eine Sicherung. Danach tragen Sie in die wp-config.php die Zeile define( 'WP_ALLOW_REPAIR', true ); ein und rufen ihre-domain.de/wp-admin/maint/repair.php auf. Nach der Reparatur muss die Zeile sofort wieder entfernt werden, weil die Seite ohne Anmeldung erreichbar ist.

Wann sollte ich den Hoster anrufen?

Wenn die Zugangsdaten nachweislich stimmen, Sie sich mit ihnen aber auch nicht in phpMyAdmin anmelden können, oder wenn der Fehler nur zeitweise auftritt. Dann liegt die Ursache meist auf dem Datenbankserver selbst: ein Ausfall, eine Überlastung, ein erreichtes Verbindungslimit oder ein voller Speicherplatz. Das kann nur der Hoster prüfen und beheben.