Fehler beim Aufbau einer Datenbankverbindung in WordPress

Die Meldung „Fehler beim Aufbau einer Datenbankverbindung“ bedeutet, dass WordPress die benötigte Datenbankverbindung nicht herstellen kann. Daraus folgt nicht, dass deine Beiträge oder Bestellungen verschwunden sind. Bevor du Passwörter änderst oder ein Backup einspielst, solltest du unterscheiden: Ist der Datenbankdienst ausgefallen, stimmen die Verbindungsdaten nicht oder liegt ein anderes Datenbankproblem vor?

In dieser Anleitung

Kurz gesagt: Prüfe zuerst, ob dein Hoster eine Datenbankstörung meldet und ob kurz zuvor ein Umzug oder eine Passwortänderung stattgefunden hat. Vergleiche dann die tatsächlich verwendete WordPress-Konfiguration mit den Daten des Hosters. Erstelle keine neue leere Datenbank als Ersatz für die vorhandene.

Bevor du anfängst

  • Beginn und Häufigkeit festhalten: dauerhafter Ausfall oder nur einzelne Zeitfenster?
  • Hosting-Status, Datenbankdienst und aktuelle Ressourcenmeldungen prüfen.
  • Letzte Änderungen an Hosting, Datenbankpasswort, Konfiguration oder Domainumzug ermitteln.

1. Verstehe, was die Meldung aussagt – und was nicht

WordPress benötigt die Datenbank unter anderem für Inhalte, Benutzer und Einstellungen. Wenn es diese Verbindung nicht aufbauen kann, fehlt die Grundlage, eine normale Seite zu erzeugen. Die Fehlermeldung verrät aber nicht, ob der Datenbankserver gerade nicht antwortet, ein Passwort falsch ist oder ein Benutzer keine passende Berechtigung hat.

Notiere deshalb zunächst, wo und wann der Fehler sichtbar wird. Funktioniert die Website morgens, fällt aber zu wiederkehrenden Zeiten aus, ist eine dauerhaft falsche Konfiguration weniger wahrscheinlich als bei einem Totalausfall direkt nach einem Umzug. Eine zwischengespeicherte Startseite kann trotzdem funktionieren. Prüfe zusätzlich eine dynamische Seite, ohne durch ständiges Neuladen zusätzliche Last zu erzeugen.

2. Prüfe den Dienst beim Hoster, bevor du WordPress änderst

Öffne den Hosting-Kundenbereich und eine eventuell vorhandene Statusseite. Gibt es einen Hinweis auf Wartungsarbeiten, eine Störung oder ausgeschöpfte Ressourcen? Manche Anbieter betreiben die Datenbank getrennt vom Webserver. Dann kann deine Website Dateien ausliefern, obwohl die Datenbankverbindung ausfällt. Eine erreichbare Hosting-Anmeldung schließt die Störung also nicht aus.

Frag beim Hoster mit einer konkreten Uhrzeit und der betroffenen Datenbank nach Verbindungsfehlern, Dienstunterbrechungen und Limits. Wenn mehrere eigene Websites auf demselben Paket gleichzeitig betroffen sind, ist das eine wichtige Information. Ändere während einer bestätigten Störung nicht zusätzlich die Datenbankzugänge: Damit könntest du einen zweiten Fehler schaffen, der nach der Entstörung bestehen bleibt.

3. Gleiche die verwendeten Verbindungsdaten sorgfältig ab

Öffne im Hosting-Dateimanager oder per SFTP das Verzeichnis, das deiner Domain zugewiesen ist. Dort findest du die Ordner wp-admin und wp-content sowie gewöhnlich die Datei wp-config.php; bei manchen Installationen liegt sie eine Ebene darüber. Lade eine geschützte Sicherung auf deinen Computer und öffne die aktive Datei zunächst nur zum Lesen in einem Texteditor. Nutze die Suchfunktion für DB_NAME, DB_USER, DB_PASSWORD und DB_HOST.

Sichere die Konfiguration vor einer Änderung und arbeite in der richtigen Installation. Auf einem Hostingpaket können eine alte Website, eine Testkopie und die aktive Website nebeneinander liegen. Änderungen an der Beispieldatei wp-config-sample.php wirken nicht automatisch auf die laufende Installation. Bei verwalteten Setups können Werte außerdem aus der Serverumgebung stammen; kläre das, bevor du zusätzliche widersprüchliche Angaben einträgst.

Das folgende Schema zeigt nur, welche Angabe wofür steht. Kopiere es nicht über deine vorhandenen Werte. DB_HOST ist der vom Hoster vorgegebene Datenbankserver und muss nicht „localhost“ heißen; je nach Anbieter sind ein eigener Hostname, Port oder Socket nötig. Das Datenbankpasswort ist außerdem nicht automatisch dein WordPress- oder Hosting-Passwort.

  1. Datenbank und Benutzer zuordnen Öffne im Hostingkonto den Bereich „Datenbanken“ beziehungsweise „MySQL/MariaDB“. Suche die Datenbank, deren Name bei DB_NAME steht. Vergleiche den zugewiesenen Benutzer mit DB_USER und die angezeigte Serveradresse mit DB_HOST. Notiere Unterschiede, ohne bereits andere Datenbanken auszuwählen oder neue anzulegen.
  2. Nur einen bestätigten Unterschied korrigieren Wenn nach einem Umzug nachweislich noch die alte Serveradresse eingetragen ist, korrigiere gezielt DB_HOST. Erhalte Anführungszeichen und Semikolon der vorhandenen PHP-Zeile und definiere den Wert nicht doppelt. Teste direkt danach die Website. Ein Passwort solltest du nur ändern, wenn der passende neue Wert und alle weiteren Nutzer dieses Datenbankkontos bekannt sind.
  3. Verbindung gezielt bestätigen Lass die Verbindung mit den tatsächlich von WordPress verwendeten Angaben prüfen. Ein automatisch angemeldetes Datenbankwerkzeug des Hosters kann andere Zugangsdaten nutzen und ist deshalb allein kein Beweis.
DB_NAME      → Name der bestehenden Website-Datenbank
DB_USER      → dieser Datenbank zugewiesener Benutzer
DB_PASSWORD  → Passwort genau dieses Datenbankbenutzers
DB_HOST      → Datenbankserver laut Hosting-Konfiguration

4. Nach einem Umzug: Bestand und Ziel verwechslungssicher prüfen

Nach einer Migration können Dateien bereits auf dem neuen Server liegen, während die Konfiguration noch auf den alten Datenbankdienst zeigt. Umgekehrt kann eine importierte Datenbank vorhanden sein, aber der neue Datenbankbenutzer besitzt keinen Zugriff. Stelle deshalb zuerst fest, welcher Server die Domain beantwortet und welche Konfiguration dort tatsächlich geladen wird.

Erscheint anstelle der bisherigen Website plötzlich der Installationsassistent, klicke ihn nicht einfach durch. Prüfe, ob die vorhandene Datenbank vollständig importiert wurde und der Tabellenpräfix zur Installation passt. Das Anlegen frischer Tabellen ersetzt keine Migration. Bei einem Shop muss außerdem feststehen, auf welchem System zuletzt Bestellungen eingegangen sind, bevor Daten zusammengeführt oder zurückgespielt werden.

Konfiguration vertraulich behandeln: Eine wp-config.php enthält Zugangsdaten und weitere Geheimnisse. Lade sie nicht in öffentliche Foren hoch und schicke keine ungeschwärzten Bildschirmfotos davon.

5. Reparatur nur bei einem belegten Tabellenproblem

Eine nicht erreichbare Datenbank und beschädigte Tabellen sind unterschiedliche Probleme. Reparaturfunktionen beheben weder einen ausgefallenen Dienst noch ein falsches Passwort. Starte deshalb keine pauschale „Datenbankoptimierung“, solange die Ursache noch unbekannt ist. Bei tatsächlichen Tabellenfehlern gehören eine Sicherung und die Bewertung durch den Hoster vor den Reparaturversuch.

Bei sporadischen Ausfällen sind zeitlich passende Protokolle besonders hilfreich. Prüfe gemeinsam mit dem Hoster, ob Verbindungsgrenzen, lange Abfragen oder parallel laufende Aufgaben beteiligt sind. Notiere dazu geplante Importe, Sicherungen und ungewöhnliche Zugriffsspitzen. Ein größeres Hostingpaket kann bei nachgewiesenem Ressourcenmangel helfen, ersetzt aber keine Prüfung einer fehlerhaften oder endlos laufenden Verarbeitung.

6. Bestätige die Reparatur und sichere den funktionierenden Zustand

Nach einer Korrektur müssen Startseite, Unterseiten und Anmeldung wieder funktionieren. Prüfe anschließend vorsichtig eine normale Speicheraktion, etwa eine Änderung an einem nicht öffentlichen Testentwurf. Bei einem Shop kontrollierst du die jüngsten Bestellungen und nutzt für Funktionstests einen geeigneten Testablauf. So bemerkst du auch, ob versehentlich eine alte Datenbank eingebunden wurde.

Beobachte bei zeitweisen Ausfällen das zuvor betroffene Zeitfenster erneut. Halte fest, welche Einstellung geändert oder welcher Dienst wiederhergestellt wurde. Für weitere Hilfe sind die Website-Adresse, genaue Ausfallzeiten, letzte Änderungen und die Rückmeldung des Hosters aussagekräftiger als eine Liste aller installierten Plugins. Datenbankpasswörter werden erst über einen geschützten Zugang übermittelt.

Häufige Fragen

Bedeutet der Datenbankfehler, dass meine Website gelöscht wurde?

Nein. Die Meldung beschreibt zunächst eine fehlgeschlagene Verbindung. Ob Inhalte vorhanden sind, wird separat an der richtigen Datenbank geprüft. Eine Neuinstallation ist deshalb kein sinnvoller erster Schritt.

Soll ich DB_HOST auf localhost ändern?

Nur wenn dein Hoster genau diesen Wert für deine Installation vorgibt. Manche Anbieter nutzen einen separaten Datenbankserver oder zusätzliche Verbindungsangaben. Ein beliebiger Standardwert kann eine zuvor richtige Konfiguration verschlechtern.

Warum klappt die Website nach wenigen Minuten wieder?

Möglich sind ein kurzzeitig gestörter Datenbankdienst, Verbindungsgrenzen oder eine lastabhängige Ursache. Die genaue Uhrzeit und passende Serverprotokolle helfen, das zu unterscheiden. Ein später erfolgreicher Aufruf allein erklärt den vorherigen Ausfall nicht.

Hilft die Wiederherstellung eines Backups?

Nur bei einem Problem, das damit tatsächlich zurückgenommen wird. Bei einer Dienststörung oder falschen aktuellen Zugangsdaten kann auch die alte Website keine Verbindung herstellen. Eine Datenbankwiederherstellung kann zudem neuere Inhalte und Bestellungen überschreiben und muss entsprechend vorbereitet werden.

WP Genius Team

WordPress-Hilfe für deine Website. Wenn du bei einem Schritt nicht weiterkommst, beschreibe uns die genaue Meldung und was du bereits geprüft hast.

Persönliche Hilfe anfragen