Fehler beim Aufbau einer Datenbankverbindung in WordPress: was er bedeutet

Was die Meldung sagt

Für jede ausgelieferte Seite öffnet WordPress eine Verbindung zu seiner MySQL- oder MariaDB-Datenbank, mit vier Angaben aus wp-config.php im Stammverzeichnis der Website:

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

„Fehler beim Aufbau einer Datenbankverbindung“ bedeutet, dass diese Verbindung gescheitert ist. Vier Ursachen führen dazu: Zugangsdaten, die nicht mehr stimmen, ein angehaltener oder nicht erreichbarer Datenbankserver, ein überlasteter Server oder eine beschädigte Datenbank. Die folgenden Abschnitte gehen sie durch, von der am einfachsten zu prüfenden bis zur seltensten.

1. Antwortet der Datenbankserver?

• Die Statusseite des Hosters: eine Störung oder Wartung des MySQL-Servers wird dort angekündigt.
• Die anderen Websites im selben Konto: zeigen sie zur selben Zeit denselben Fehler, liegt die Ursache beim Server, und die Lösung beim Hoster.
• phpMyAdmin, aus dem Control Panel des Hosters: öffnet es die Datenbank und zeigt ihre Tabellen, läuft der Server und die Datenbank existiert.

Liegt es am Server, eröffnen Sie beim Hoster ein Ticket mit dem Beginn der Störung und der genauen Meldung. An der Website ist in der Zwischenzeit nichts zu ändern.

2. Stimmen die Zugangsdaten in wp-config.php?

Das ist die häufigste Ursache nach einem Umzug der Website, einer Änderung des Datenbankpassworts im Control Panel des Hosters oder einer Wiederherstellung. Vergleichen Sie die vier Werte in wp-config.php mit dem Datenbankbereich Ihres Hosters:

• DB_NAME und DB_USER: viele Hoster stellen ihnen den Kontonamen voran (konto_wordpress). Das Präfix gehört zum Namen.
• DB_PASSWORD: im Zweifel legen Sie im Control Panel ein neues Passwort für den Benutzer fest und tragen es in die Datei ein.
• DB_HOST: localhost bei vielen Hostern, aber nicht bei allen. Manche nennen einen Servernamen oder eine Adresse, manchmal gefolgt von einem Port (:3306). Der genaue Wert steht im Control Panel.
• Der Benutzer braucht Rechte an der Datenbank: prüfen Sie im Control Panel, dass der Benutzer der Datenbank zugeordnet ist, mit allen Berechtigungen.

Ein Passwort mit einem Apostroph (') beendet die PHP-Zeichenkette, die es in wp-config.php umschließt. Setzen Sie einen Backslash davor (\') oder wählen Sie ein Passwort ohne Apostroph.

Die Zugangsdaten außerhalb von WordPress testen

WordPress zeigt eine allgemeine Meldung. MySQL dagegen sagt genau, was nicht stimmt. Zwei Wege, es mit den Werten aus wp-config.php zu befragen:

Auf der Kommandozeile, wenn Sie SSH-Zugang haben

mysql -h localhost -u benutzername -p datenbankname

Mit WP-CLI liest wp db check die Datei wp-config.php direkt und prüft die Tabellen mit diesen Zugangsdaten.

Mit einer temporären PHP-Datei

Legen Sie diese Datei unter einem schwer zu erratenden Namen im Stammverzeichnis der Website ab, öffnen Sie sie im Browser und löschen Sie sie sofort wieder: sie enthält das Datenbankpasswort.

<?php
mysqli_report(MYSQLI_REPORT_OFF);
$verbindung = @mysqli_connect('localhost', 'benutzername', 'passwort', 'datenbankname');
echo $verbindung ? 'Verbindung erfolgreich' : 'Fehlgeschlagen: ' . mysqli_connect_error();

Die erste Zeile zählt: seit PHP 8.1 löst eine gescheiterte Verbindung standardmäßig eine Exception aus, und die Seite bliebe weiß, statt die Meldung von MySQL anzuzeigen.

3. Eine beschädigte Datenbank: das Reparaturwerkzeug

Stimmen die Zugangsdaten, sind aber Tabellen beschädigt, zeigt die öffentliche Website dieselbe Meldung zur Datenbankverbindung und das Dashboard eine genauere: „Eine oder mehrere Datenbanktabellen sind nicht verfügbar. Möglicherweise muss die Datenbank repariert werden.“ WordPress bringt dafür ein Werkzeug mit. Fügen Sie diese Zeile in wp-config.php ein:

define( 'WP_ALLOW_REPAIR', true );

Öffnen Sie dann https://www.ihre-website.com/wp-admin/maint/repair.php und starten Sie „Datenbank reparieren“. Entfernen Sie die Zeile, sobald die Reparatur abgeschlossen ist: solange sie vorhanden ist, kann jeder diese Seite ohne Anmeldung aufrufen.

Exportieren Sie vor jeder Reparatur die Datenbank (wp db export oder der Reiter Exportieren in phpMyAdmin). Scheitert die Reparatur, kann der Hoster die Datenbank aus seinen Backups wiederherstellen.

4. Ein Fehler, der kommt und geht: die Last

Ein Fehler, der zu bestimmten Zeiten auftritt und von selbst wieder verschwindet, deutet eher auf einen überlasteten Server als auf eine falsche Einstellung. Die häufigsten Ursachen:

• Eine Verkehrsspitze, oft durch Bots: wiederholte Anmeldeversuche an wp-login.php oder xmlrpc.php, sichtbar in den Zugriffslogs des Hosters.
• Die Limits des Shared Hostings: Zahl der gleichzeitigen Verbindungen oder Prozesse pro Konto begrenzt. Das Control Panel des Hosters zeigt sie meist im Bereich zum Ressourcenverbrauch.
• Ein schweres Plugin: Statistiken, Logs oder geplante Aufgaben, die bei jedem Besuch in die Datenbank schreiben.

Die Lösungen: missbräuchliche Anmeldeversuche blockieren, einen Seiten-Cache einrichten, xmlrpc.php deaktivieren, wenn keine Anwendung die Datei nutzt, und beim Hoster die Logs für den Zeitraum des Fehlers anfordern.