WordPress Fehler beim Aufbau der Datenbankverbindung: Ursachen und Lösung

Was bedeutet der Fehler beim Aufbau der Datenbankverbindung in WordPress und was tun Sie zuerst?

Der Fehler beim Aufbau der Datenbankverbindung bedeutet, dass WordPress die MySQL Datenbank mit Ihren Inhalten nicht erreicht. WordPress liest jede Seite aus dieser Datenbank, deshalb fällt bei einer unterbrochenen Verbindung die gesamte Website aus. Meist stecken also falsche Angaben in der wp-config.php, ein stummer Datenbankserver oder defekte Tabellen dahinter.

Bleiben Sie ruhig und gehen Sie in dieser Reihenfolge vor:

1. Laden Sie die Seite nach einer Minute neu, denn kurze Lastspitzen zeigen dieselbe Meldung.
2. Öffnen Sie Ihr Hosting Panel und prüfen Sie, ob das Datenbank Werkzeug lädt.
3. Vergleichen Sie Datenbankname, Benutzer, Passwort und Host in der wp-config.php mit dem Panel.
4. Stimmen die Angaben, fragen Sie Ihren Anbieter, ob der Datenbankserver läuft.
5. Laden Sie vor jeder Änderung eine Kopie der Dateien und der Datenbank herunter.

Deshalb erklären wir in diesem Ratgeber jeden Schritt nach Ursache. Dann raten Sie nicht, sondern starten an der richtigen Stelle. Außerdem bitten wir Sie an keiner Stelle, echte Passwörter oder Benutzernamen zu teilen.

Wann taucht diese Fehlermeldung auf?

WordPress spricht bei jeder Seitenanfrage mit der Datenbank. Denn Beiträge, Seiten, Einstellungen und Benutzer liegen dort. Scheitert die Verbindung, gibt WordPress also eine kurze Fehlermeldung aus und lädt nichts weiter. In englischen Oberflächen lautet sie "Error establishing a database connection". Die deutsche Oberfläche zeigt eine entsprechende Übersetzung, deren genauer Wortlaut je nach Version leicht abweichen kann.

Der Fehler erscheint meist in diesen Situationen:

• Direkt nach dem Umzug zu einem neuen Hoster oder auf eine neue Domain.
• Nachdem Sie das Datenbank Passwort im Panel geändert haben.
• Wenn der Traffic plötzlich steigt und ein Ressourcenlimit voll läuft.
• Falls Ihr Anbieter Wartungsarbeiten macht oder den Server neu startet.
• Sobald Tabellen bei einem Plugin oder Update beschädigt werden.

Daher liefert der Zeitpunkt einen starken Hinweis. Zunächst gilt: Begann der Fehler direkt nach einer Änderung, suchen Sie nach abweichenden Angaben. Begann er dagegen von allein, schauen Sie auf Server und Ressourcen. Somit spart Ihnen diese einfache Trennung lange Experimente.

Ist es wirklich ein Fehler beim Aufbau der Datenbankverbindung?

Nicht jeder weiße Bildschirm ist ein Datenbankfehler. Stellen Sie deshalb zuerst die richtige Diagnose. Denn mehrere WordPress Probleme sehen ähnlich aus, und jedes braucht eine andere Lösung.

Zum Beispiel stammt die Meldung über einen kritischen Fehler auf der Website aus abgestürztem Plugin oder Theme Code. Diesen Fall behandeln wir im Ratgeber WordPress kritischer Fehler beheben. Ein komplett weißer Bildschirm kann dagegen von einem PHP Fehler oder zu wenig Speicher kommen. Bei einem allgemeinen Serverausfall hilft Ihnen der 500 Internal Server Error Ratgeber.

Den Datenbankfehler erkennen Sie daran, dass die Meldung die Datenbankverbindung nennt und keine Seite der Website lädt. Allerdings zeigen manche Installationen einen leicht anderen Wortlaut. Behandeln Sie das dann als ähnliche Warnung und folgen Sie derselben Prüfreihenfolge.

Zwei Fragen beschleunigen die Diagnose. Lädt die Anmeldeseite? Tritt der Fehler auf jeder Seite auf? Fallen also Frontend und Dashboard gemeinsam aus, ist ein Verbindungsproblem sehr wahrscheinlich.

Wie beheben Sie den Fehler beim Aufbau der Datenbankverbindung in der wp-config.php?

Die offizielle WordPress Dokumentation nennt falsche Angaben in der wp-config.php als häufigste Ursache. Konkret erreichen Sie die Datei per FTP Programm oder über den Dateimanager im Hosting Panel. Sie liegt außerdem im Hauptverzeichnis Ihrer WordPress Installation.

Vergleichen Sie vier Werte mit dem Panel:

• Name: Er muss exakt zum Panel passen, denn manche Anbieter setzen ein Konto Präfix davor.
• Benutzer: Auch dieser Wert kann ein Präfix tragen und zwischen Groß und Kleinschreibung unterscheiden.
• Passwort: Am Anfang und am Ende darf kein Leerzeichen stehen.
• Host: Viele Anbieter akzeptieren localhost, einige nennen jedoch eine eigene Adresse.

Öffnen Sie die Datei in einem Code Editor und nicht in einer Textverarbeitung. Denn Textverarbeitungen machen aus geraden Anführungszeichen typografische und zerstören die Datei. Speichern Sie außerdem vor dem Bearbeiten eine Kopie auf Ihrem Rechner. Dann stellen Sie bei einem Fehlgriff sofort den alten Stand wieder her.

Behalten Sie beim Bearbeiten die Struktur bei. Dabei steht jeder Wert zwischen Anführungszeichen. Ändern Sie nur den Inhalt dazwischen und laden Sie die Datei über die alte hoch.

Was tun, wenn das Passwort nicht passt?

Zunächst zur Passwortfrage: Ein abweichendes Passwort ist eine sehr häufige Ursache. Setzen Sie das Passwort im Panel zurück und vergessen die Datei, beginnt der Fehler sofort. Ebenso bringt ein altes Backup das alte Passwort zurück in die Datei. Das heißt, ein Backup dreht auch das Passwort zurück.

So gehen Sie am sichersten vor:

1. Vergeben Sie im Hosting Panel ein neues Passwort für den Datenbankbenutzer.
2. Speichern Sie das Passwort in einem Passwortmanager.
3. Kopieren Sie denselben Wert in das Passwortfeld der wp-config.php.
4. Speichern Sie die Datei und laden Sie die Seite neu.

Die WordPress Dokumentation rät außerdem, das MySQL Passwort manuell zurückzusetzen, wenn Ihre Konfiguration korrekt wirkt. Daher kopieren Sie bei komplexen Passwörtern den Wert, statt ihn zu tippen. Teilen Sie echte Passwörter nirgends per Chat oder E-Mail, sondern stattdessen nutzen Sie den sicheren Kanal im Panel.

Nutzt eine weitere Anwendung denselben Datenbankbenutzer, aktualisieren Sie auch sie. Zum Beispiel arbeitet eine zweite Website oder ein geplanter Backup Job sonst mit dem alten Passwort weiter und scheitert. So lösen Sie nicht ein Problem und schaffen das nächste.

Warum kann der Datenbank Host falsch sein?

Zunächst sagt das Host Feld WordPress, auf welchem Server die Datenbank liegt. Bei vielen Shared Hosting Tarifen lautet der Wert localhost, weil die Datenbank auf demselben Rechner wie der Webserver liegt. Allerdings betreiben manche Anbieter die Datenbank auf einer separaten Maschine und nennen Ihnen eine eigene Adresse.

Der Host bleibt in diesen Fällen falsch:

• Sie sind zu einem neuen Anbieter gezogen, und die alte Adresse steht noch in der Datei.
• Ihr Anbieter hat den Datenbankserver auf eine andere Maschine verlegt.
• Die Einrichtung braucht eine Portnummer, die Sie nicht ergänzt haben.

Den richtigen Wert finden Sie auf der Datenbank Infoseite im Panel oder in der Hilfe Ihres Anbieters. Raten Sie nicht, sondern prüfen Sie den Wert an der Quelle. Denn ein falscher Host löst meist dieselbe allgemeine Meldung aus. Deshalb spart die Prüfung an der Quelle Zeit.

Was passiert, wenn dem Datenbankbenutzer Rechte fehlen?

Selbst bei korrekten Angaben lehnt der Server die Verbindung ab, wenn der Benutzer der Datenbank nicht zugeordnet ist. Dabei sind in den meisten Panels Datenbank anlegen und Benutzer anlegen getrennte Schritte. Vergessen Sie, den Benutzer zuzuweisen und die nötigen Rechte zu geben, erhalten Sie denselben Fehler.

Das passiert daher häufig bei Neuinstallationen und Umzügen. Zum Beispiel legen Sie eine neue Datenbank an und importieren den Inhalt, aber Sie fügen den Benutzer nie hinzu. WordPress sendet dann das richtige Passwort, und der Server verweigert trotzdem den Zugriff.

Prüfen Sie im Panel: Steht der Benutzer bei der richtigen Datenbank, und sind die Rechte gesetzt? Eine Anleitung Schritt für Schritt finden Sie im Ratgeber MySQL Datenbank in cPanel anlegen mit Benutzer und Rechten. Das Anlegen behandeln wir dort ausführlich, deshalb wiederholen wir es hier nicht.

Zudem listen manche Panels Rechte einzeln auf. WordPress muss in der eigenen Datenbank Tabellen anlegen, lesen und ändern dürfen. Fehlt ein Recht, läuft ein Teil der Website und ein Teil nicht. Weil die genaue Liste je nach Anbieter variiert, wählen Sie die Option für alle Rechte auf genau diese eine Datenbank.

Wie erkennen Sie, dass der Datenbankserver nicht antwortet?

Stimmen Ihre Angaben, liegt das Problem womöglich beim Server. Konkret kann der Datenbankserver abgestürzt, in Wartung oder überlastet sein. Die WordPress Dokumentation nennt einen ausgefallenen Server ausdrücklich unter den Ursachen auf Hosting Seite.

Diese Anzeichen sprechen für ein Serverproblem:

• Das Datenbank Werkzeug im Hosting Panel lädt sehr langsam oder gar nicht.
• Andere Websites auf demselben Server zeigen denselben Fehler.
• Der Fehler kommt und geht, und manchmal hilft ein Neuladen.
• Die Statusseite oder die Ankündigungen Ihres Anbieters erwähnen Wartungsarbeiten.

Sehen Sie diese Zeichen, ändern Sie die wp-config.php nicht. Denn korrekte Angaben zu verändern macht alles nur schlimmer. Schreiben Sie stattdessen Ihrem Anbieter mit der Uhrzeit des Fehlers und den betroffenen Domains. Notieren Sie außerdem, wie lange das Problem anhält, damit das Support Team konkrete Fakten bekommt.

Stellen Sie eine gezielte Frage: Gab es zu diesen Zeiten einen Ausfall oder Wartungsarbeiten am Datenbankserver? Eine konkrete Frage bringt schneller Antwort als eine allgemeine Beschwerde. Dann können Sie vorübergehend eine einfache Wartungsseite einblenden, damit Besucher einen klaren Hinweis statt einer rohen Fehlermeldung sehen.

Wie lösen Ressourcenlimits und Kontingente diesen Fehler aus?

Zunächst begrenzen Shared Hosting Tarife Datenbankverbindungen, Speicher und Rechenzeit. Überschreitet Ihre Website eine Grenze, lehnt der Anbieter Verbindungen zeitweise ab. WordPress erreicht die Datenbank dann nicht mehr und zeigt dieselbe Meldung.

Die WordPress Dokumentation erwähnt außerdem, dass eine Datenbank ihr Kontingent erreichen und abgeschaltet werden kann. Ist das Kontingent voll, stoppen Schreibvorgänge, und manchmal antwortet die Datenbank gar nicht mehr.

Typische Gründe für ein erreichtes Limit sind:

• Ein plötzlicher Traffic Anstieg oder intensives Crawling durch Bots.
• Ein träges Plugin mit ineffizienten Abfragen.
• Aufgeblähte temporäre Daten und alte Revisionen.
• Ein Tarif, der für die Website zu klein ausfällt.

Wie diese Grenzen funktionieren, lesen Sie im Ratgeber Ressourcenlimits im Shared Hosting: CPU, RAM und I/O. Zur Geschwindigkeit passt der Beitrag wie die Ladezeit das SEO beeinflusst.

Allerdings ist ein größerer Tarif nicht die einzige Lösung. Klären Sie zunächst, woher die Last kommt. Ungenutzte Plugins zu entfernen, Caching einzurichten und Bilder zu verkleinern kostet oft weniger als ein Upgrade. Ist der Traffic aber wirklich gewachsen, lohnt ein stärkerer Tarif. Aktuelle Kontingente und Limits prüfen Sie auf den Seiten Ihres Anbieters.

Wie nutzen Sie WP_ALLOW_REPAIR bei defekten Tabellen?

Manchmal steht die Verbindung, aber Tabellen sind dagegen beschädigt. Ein Stromausfall, ein Serverabsturz oder ein unterbrochenes Update können das auslösen. WordPress bringt dafür ein eigenes Reparaturwerkzeug mit.

Laut offizieller Dokumentation aktivieren Sie es, indem Sie in der wp-config.php eine Zeile ergänzen, die die Konstante WP_ALLOW_REPAIR auf true setzt. Danach rufen Sie auf Ihrer Website den Pfad wp-admin/maint/repair.php auf. Die Seite bietet die Reparatur sowie die Reparatur mit Optimierung an.

Beachten Sie drei Punkte:

1. Erstellen Sie zuerst ein Backup, denn die Reparatur verändert Tabellen.
2. Laut Dokumentation brauchen Benutzer bei aktiver Funktion keine Anmeldung, also erreicht jeder die Seite.
3. Entfernen Sie die Zeile, sobald die Reparatur fertig ist.

Vergessen Sie die Zeile, können dann Fremde die Reparaturseite öffnen. Halten Sie die Sitzung deshalb kurz und prüfen Sie am Ende, dass die Seite nicht mehr funktioniert. Einen Code Block zeigen wir hier bewusst nicht, denn die genaue Zeile steht in der offiziellen Dokumentation.

Nach der Reparatur listet WordPress auf, welche Tabellen es geprüft und repariert hat. Bleibt der Fehler, liegt die Ursache folglich woanders. Das Werkzeug repariert nur Tabellen und löst keine falschen Verbindungsdaten. Sind die Angaben falsch, öffnet sich auch die Reparaturseite nicht, also lösen Sie zuerst die Verbindung.

Warum tritt der Fehler beim Aufbau der Datenbankverbindung nach einem Umzug so oft auf?

Ein Umzug auf einen neuen Hoster, eine neue Domain oder von einer lokalen Umgebung auf den Live Server löst diesen Fehler häufig aus. Der Grund ist einfach, denn Datenbankname, Benutzer und Host unterscheiden sich in jeder Umgebung. Kopieren Sie nur die Dateien und lassen die alten Werte in der wp-config.php, scheitert die Verbindung.

Gehen Sie nach einem Umzug diese Liste durch:

• Haben Sie die Datenbank beim neuen Anbieter angelegt?
• Haben Sie das Backup in die richtige Datenbank importiert?
• Ist der Benutzer der Datenbank zugeordnet und mit Rechten versehen?
• Stimmen alle vier Werte in der wp-config.php mit dem neuen Panel überein?
• Lief der Import ohne Fehler und ohne Unterbrechung durch?

Die Sicherungsseite behandelt unser Ratgeber Datenbank Backup und Wiederherstellung. Den ganzen Umzug planen Sie mit der Checkliste für den Webhosting Wechsel. So prüfen Sie alles, bevor Sie den alten Server löschen.

Verwechseln Sie den Domain Umzug nicht mit dem Hosting Umzug. Denn eine Domain umzuleiten ändert keine Datenbankangaben. Stattdessen ändert sich der Server, auf dem Ihre Dateien liegen. Tragen Sie nach einem Umzugsfehler daher die Werte des neuen Servers ein, denn die alten gelten womöglich nicht mehr.

Was bedeutet es, wenn das Dashboard eine andere Meldung zeigt?

Manchmal lädt das Frontend, aber das Dashboard zeigt eine andere Meldung. Das heißt, WordPress erreicht die Datenbank und stößt auf ein anderes Problem. Wenden Sie deshalb nicht dieselbe Lösung an wie bei einer gescheiterten Verbindung.

So ordnen wir die Fälle ein, die Ihnen begegnen können:

• Eine ähnliche Warnung, dass Tabellen fehlen oder repariert werden müssen. Probieren Sie dann das Reparaturwerkzeug.
• Eine Aufforderung, die Datenbank zu aktualisieren. Das ist ein eigener Update Ablauf.
• Nur das Dashboard fällt aus, während das Frontend läuft. Meist steckt ein Plugin oder Theme Konflikt dahinter.

Der genaue Wortlaut kann außerdem je nach Version und Sprache wechseln. Bleiben Sie daher nicht am Text hängen. Fragen Sie, ob die Meldung die Verbindung, die Tabellen oder ein Update betrifft, und handeln Sie nach dieser Ursache.

Kann auch eine gehackte Website den Fehler beim Aufbau der Datenbankverbindung auslösen?

Ja, das kann passieren. Die WordPress Dokumentation führt eine kompromittierte Website unter den möglichen Ursachen auf. Zum Beispiel hat ein Angreifer Datenbankangaben geändert, Tabellen gelöscht oder Dateien beschädigt.

Diese Anzeichen deuten auf ein Sicherheitsproblem:

• Sie haben nichts geändert, trotzdem sind die Angaben plötzlich falsch.
• In Ihren Dateien liegen neue Einträge, die Sie nicht kennen, oder auffällige Datumsangaben.
• Suchergebnisse zeigen Inhalte auf Ihrer Domain, die Sie nie veröffentlicht haben.
• Ihr Anbieter hat eine Malware Warnung geschickt.

Ändern Sie dann Ihre Passwörter und prüfen Sie Ihr Backup. Detaillierte Schritte finden Sie im Ratgeber WordPress Seite gehackt: was tun in den ersten 24 Stunden. Geben Sie außerdem niemals Zugang an Unbekannte, die gegen Bezahlung eine Rettung anbieten. Denn das schafft ein zweites Sicherheitsproblem.

Bringen Sie die Schritte in die richtige Reihenfolge. Ändern Sie zunächst Ihre Admin und Hosting Passwörter. Danach vergleichen Sie Dateiänderungen mit den Protokollen Ihres Anbieters. Somit ist ein sauberes Backup oft der sicherste Weg. Versuchen Sie keine Abkürzungen, die Systeme umgehen, denn sie gefährden Ihr Konto und Ihre Kunden.

Welches Symptom deutet auf welche Ursache?

Die Tabelle ordnet jedem Symptom eine mögliche Ursache zu. Sie zeigt, wo Sie zuerst suchen, und ersetzt keine echte Diagnose.

Die Reihenfolge in der Tabelle ist nicht streng. Mehrere Ursachen können zugleich vorliegen, also schließen Sie jede Prüfung der Reihe nach ab.

Wie sieht die vollständige Checkliste für den Fehler beim Aufbau der Datenbankverbindung aus?

Die folgende Liste fasst den ganzen Artikel zusammen. Gehen Sie die Schritte ohne Auslassung durch, und notieren Sie nach jedem Schritt kurz das Ergebnis.

1. Laden Sie die Seite neu und testen Sie einen anderen Browser.
2. Prüfen Sie, ob Hosting Panel und Datenbank Werkzeug öffnen.
3. Schauen Sie auf die anderen Websites im selben Konto.
4. Laden Sie ein Backup herunter.
5. Vergleichen Sie Name, Benutzer, Passwort und Host in der wp-config.php mit dem Panel.
6. Bestätigen Sie, dass der Benutzer der richtigen Datenbank samt Rechten zugeordnet ist.
7. Prüfen Sie Ressourcenverbrauch und Kontingent.
8. Schalten Sie bei Bedarf das Reparaturwerkzeug ein, nutzen Sie es und schalten Sie es wieder aus.
9. Benennen Sie den Plugin Ordner kurz um, um eine Plugin Ursache zu testen.
10. Bleibt alles ohne Erfolg, wenden Sie sich mit allen Fakten an Ihren Anbieter.

Halten Sie diese Liste bereit, wenn der Fehler auftritt, und ergänzen Sie eigene Notizen zu Ihrem Hosting Panel. In den meisten Fällen finden Sie die Ursache schon in den ersten fünf Schritten.

Wie verhindern Sie, dass der Fehler zurückkehrt?

Nach der Lösung bauen Sie ein paar Gewohnheiten auf. Denn die meisten Datenbankfehler entstehen durch vermeidbare Änderungen.

• Sichern Sie regelmäßig. Bewahren Sie Dateien und Datenbank auf. Unser Ratgeber zur Website Backup Strategie liefert Ihnen eine Routine.
• Ändern Sie ein Passwort, aktualisieren Sie beide Stellen: Panel und wp-config.php.
• Halten Sie Plugins und Themes aktuell, doch erstellen Sie vor jedem Update ein Backup.
• Löschen Sie ungenutzte Plugins, damit die Datenbank weniger Last trägt.
• Beobachten Sie den Ressourcenverbrauch und prüfen Sie den Tarif, wenn Sie sich einem Limit nähern.
• Arbeiten Sie bei jedem Umzug mit einer Checkliste.

Schalten Sie außerdem die Reparaturkonstante und Debug Konstanten ab, sobald Sie fertig sind. Jede liegen gebliebene Diagnosefunktion ist ein kleines Sicherheitsrisiko. Eine feste Wartungsroutine schützt Sie auch am umsatzstärksten Tag.

Testen Sie Ihre Sicherung außerdem einmal im Monat. Eine Backup Datei zu haben ist das eine, ein Backup, das sich zurückspielen lässt, das andere. Verfolgen Sie zudem die Wartungshinweise Ihres Anbieters und vermeiden Sie große Änderungen kurz vor wichtigen Kampagnen.

Wann sollten Sie Ihren Anbieter oder einen Experten um Hilfe bitten?

Haben Sie die Checkliste abgearbeitet und der Fehler bleibt, ist es Zeit für Hilfe. Nur Ihr Anbieter sieht den Datenbankserver, also schreiben Sie ihm zuerst.

Nennen Sie in Ihrer Anfrage diese Fakten:

• Datum und Uhrzeit des Fehlerbeginns.
• Die letzte Änderung vor dem Fehler.
• Ob das Datenbank Werkzeug in Ihrem Panel öffnet.
• Den Zustand anderer Websites im selben Konto.
• Dass Sie die Angaben der wp-config.php bereits mit dem Panel verglichen haben.

So grenzt das Support Team das Problem schneller ein. Liegt die Ursache im Code, holen Sie einen erfahrenen WordPress Entwickler dazu. Vertrauen Sie niemandem, der Ergebnisse garantiert, Vorkasse verlangt oder Zugangsdaten per Nachricht fordert. Keine Rettungsmethode garantiert ein Ergebnis.

Wie unterstützen Talha Aslan und Team Sie dabei?

Wir sind ein Digitalmarketing Team aus Istanbul und kein Hosting Unternehmen. Wir betreiben daher keine Server. Dennoch prüfen wir gern mit Ihnen die Struktur Ihrer Website, Ihr WordPress Setup und mögliche Schwachstellen.

Bauen oder erneuern Sie eine Website, plant unser Webdesign Angebot Wartung, Backups und Umzug von Beginn an mit. Deshalb wollen wir solche Ausfälle früh verringern. Zur Messung der Seitenleistung probieren Sie außerdem unsere Tools aus.

Dieser Artikel liefert allerdings nur allgemeine Informationen. Servereinstellungen unterscheiden sich je nach Anbieter, daher können Menünamen und Schritte abweichen. Aktuelle Angaben prüfen Sie in den offiziellen WordPress Quellen: häufige WordPress Fehler, die Dokumentation zur Konfigurationsdatei und die WordPress Support Foren.