WordPress: Fehler beim Herstellen einer Datenbankverbindung

Was dieser Fehler bedeutet und wie du ihn erkennst

• Die Website zeigt nur „Fehler beim Herstellen einer Datenbankverbindung“ an, oft auf jeder Seite des Frontends.
• Auch /wp-admin/ ist nicht verfügbar, da dieselbe Datenbankverbindung verwendet wird.
• Der Fehler kann nach einer Migration, einem Hosting-Wechsel, der Wiederherstellung einer Datenbank, einer manuellen Änderung an wp-config.php, einer Passwortänderung oder einem Neustart des Datenbankservers auftreten.
• Wenn nur bestimmte Seiten fehlschlagen, während andere datenbankgestützte Seiten funktionieren, kann das Problem seiten-, plugin-, theme- oder abfragespezifisch sein und nicht auf einen vollständigen Ausfall der Datenbankverbindung hindeuten.

Hauptursachen nach Wahrscheinlichkeit

1. Falsche Zugangsdaten in wp-config.php — DB_NAME, DB_USER, DB_PASSWORD oder DB_HOST stimmen nicht mehr mit der aktuellen Datenbankkonfiguration überein. Das kommt besonders häufig nach einer Migration, Wiederherstellung, Passwortänderung oder manuellen Bearbeitung vor.
2. Ein nicht verfügbarer MySQL- oder MariaDB-Server — der Dienst wurde möglicherweise beendet, ist abgestürzt oder aufgrund eines Ressourcenproblems beim Hosting nicht verfügbar.
3. Der falsche Datenbankhost — localhost kann falsch sein, wenn die Datenbank auf einem anderen Server oder in einem anderen Container läuft. Umgekehrt kann ein Remote-Host-Wert nicht mehr zur aktuellen Umgebung passen.
4. Fehlende Berechtigungen des Datenbankbenutzers — der Benutzer kann zwar vorhanden, aber nicht der WordPress-Datenbank zugewiesen sein oder nicht über die erforderlichen Berechtigungen verfügen.
5. Beschädigte Datenbanktabellen — ein unterbrochener Schreibvorgang, ein unsauberer Shutdown oder ein Festplattenproblem kann Tabellen beschädigen. Dies ist jedoch in der Regel weniger wahrscheinlich als ein Konfigurations- oder Verfügbarkeitsproblem.

So behebst du den Fehler

1. Umfang des Fehlers feststellen

Öffnen Sie die öffentliche Website und /wp-admin/. Wenn beide den Verbindungsfehler anzeigen, fahren Sie mit den unten beschriebenen Datenbankprüfungen fort. Wenn nur eine Seite oder Funktion fehlschlägt, untersuchen Sie stattdessen das betreffende Plugin, Theme, die Abfrage oder den Anwendungsfehler, anstatt von einer nicht verfügbaren Datenbankverbindung auszugehen.

2. Prüfen, ob MySQL oder MariaDB läuft

Wenn Sie für die Dienstverwaltung eines VPS oder dedizierten Servers verantwortlich sind, prüfen Sie den Status des entsprechenden Dienstes. Diese Befehle sind schreibgeschützt und erfordern Shell-Zugriff:

systemctl status mysql

Wenn der Server MariaDB verwendet, prüfen Sie:

systemctl status mariadb

Verwenden Sie bei Shared oder Managed Hosting die Datenbankstatusinformationen im Hosting-Panel oder bitten Sie den Anbieter, den Dienst und die Ressourcenlimits zu prüfen. Starten Sie einen Datenbankdienst nur neu, wenn Sie diesen Server verwalten, über die entsprechende Berechtigung verfügen und bestätigt haben, dass die betrieblichen Auswirkungen vertretbar sind. Ein Neustart kann aktive Datenbankverbindungen unterbrechen.

3. Die vier Datenbankeinstellungen in wp-config.php überprüfen

Öffnen Sie wp-config.php über SFTP oder den Dateimanager des Hostings. Vergleichen Sie diese Werte mit den aktuellen Datenbankdaten im Hosting-Panel oder in den Migrationsunterlagen:

• DB_NAME — die von WordPress zu verwendende Datenbank
• DB_USER — der Datenbankbenutzername
• DB_PASSWORD — das aktuelle Passwort dieses Benutzers
• DB_HOST — die Adresse oder Host-Einstellung des Datenbankservers

Achten Sie auf einen veralteten Datenbanknamen, ein nicht mehr gültiges Passwort, einen falschen Host sowie versehentlich veränderte Leerzeichen oder Anführungszeichen. Gehen Sie nach einer Migration, einem Hosting-Wechsel, einer Datenbankwiederherstellung oder einer Passwortzurücksetzung nicht davon aus, dass die bisherigen Werte weiterhin gültig sind.

4. Dieselbe Verbindung außerhalb von WordPress testen

Verwenden Sie phpMyAdmin oder die MySQL-Kommandozeile mit genau dem Datenbanknamen, Benutzernamen, Passwort und Host aus wp-config.php. Dieser Test sollte in derselben Umgebung und mit denselben Zugangsdaten erfolgen, die WordPress verwendet.

• Wenn die direkte Verbindung fehlschlägt, untersuchen Sie Zugangsdaten, Datenbankhost, Serververfügbarkeit oder Netzwerkzugriff, bevor Sie WordPress-Dateien ändern.
• Wenn die direkte Verbindung erfolgreich ist, funktioniert der grundlegende Pfad zwischen Server und Zugangsdaten. Prüfen Sie anschließend die Zuweisung des Datenbankbenutzers, die Berechtigungen und den Zustand der Tabellen.

Veröffentlichen Sie niemals das Passwort oder die vollständige Datei wp-config.php, wenn Sie Unterstützung anfordern.

5. Zugriff und Berechtigungen des Datenbankbenutzers bestätigen

Prüfen Sie im Bereich für Datenbankbenutzer des Hosting-Panels, ob der Benutzer aus wp-config.php der korrekten WordPress-Datenbank zugewiesen ist und die Berechtigung besitzt, ihre Tabellen zu lesen und zu ändern. Diese Prüfung ist besonders nach der Wiederherstellung einer Datenbank unter einem neuen Konto oder nach dem Anlegen eines Ersatzbenutzers wichtig.

Wenn Sie MySQL direkt verwalten, kann ein autorisierter Administrator die Berechtigungen des Kontos mit SHOW GRANTS prüfen. Korrigieren Sie die Zuordnung des Benutzers zur Datenbank oder die Berechtigungen erst, nachdem Sie die vorgesehene Datenbank und das richtige Konto bestätigt haben. Wiederholen Sie anschließend den direkten Verbindungstest und laden Sie die Website neu.

6. Tabellenprobleme erst prüfen, wenn die Verbindung funktioniert

Wenn der Datenbankserver verfügbar ist, die genauen Zugangsdaten in einem direkten Test funktionieren und der Benutzer Zugriff hat, prüfen Sie die WordPress-Tabellen in phpMyAdmin oder mit einem autorisierten Datenbanktool. CHECK TABLE kann Tabellenprobleme melden.

Erstellen Sie vor einem Reparaturversuch eine aktuelle Datenbanksicherung oder überprüfen Sie, ob eine solche vorhanden ist. REPAIR TABLE ist hauptsächlich für unterstützte MyISAM-Tabellen relevant und keine universelle Reparaturmethode. Führen Sie Reparaturbefehle nicht wiederholt aus, wenn die Prüfungen keine Beschädigung melden. Untersuchen Sie stattdessen weiterhin Host, Konfiguration, Berechtigungen und Serverprotokolle.

7. Die vollständige Website nach der Behebung prüfen

Laden Sie mehrere öffentliche Seiten und /wp-admin/. Wenn beide funktionieren, leeren Sie nur die relevanten Caching-Ebenen, falls weiterhin veraltete Ausgaben angezeigt werden. Wenn einer der Bereiche weiterhin fehlschlägt, notieren Sie die aktuell angezeigte genaue Meldung und prüfen Sie die Server- oder Hosting-Protokolle, anstatt davon auszugehen, dass das ursprüngliche Verbindungsproblem unverändert besteht.

Vorbeugung und Überprüfung der Lösung

• Bewahren Sie aktuelle Angaben zu Datenbankname, Benutzer, Host und Passwort in einem geschützten Passwortmanager oder einer vergleichbar sicheren Aufzeichnung auf.
• Testen Sie nach jeder Migration oder jedem Hosting-Wechsel sowohl die öffentliche Website als auch /wp-admin/, bevor Sie den Umzug abschließen.
• Erstellen Sie regelmäßig Datenbanksicherungen und prüfen Sie in regelmäßigen Abständen, ob eine Wiederherstellung möglich ist.
• Dokumentieren Sie, welcher Datenbankbenutzer welcher WordPress-Datenbank zugewiesen ist, damit eine Wiederherstellung oder der Austausch eines Benutzers den Zugriff nicht unbemerkt entfernt.
• Prüfen Sie verfügbare Warnungen zu Hosting-Ressourcen und Ereignisse des Datenbankdienstes, insbesondere nach unerwarteten Neustarts oder wiederkehrenden Verbindungsfehlern.
• Beschränken Sie den Zugriff auf wp-config.php und vermeiden Sie es, deren Inhalt oder Zugangsdaten in Supportanfragen weiterzugeben.

Häufig gestellte Fragen