„Fehler beim Aufbau einer Datenbankverbindung“ — die vier Ursachen

Anders als der kritische Fehler ist diese Meldung präzise: PHP läuft, WordPress startet, aber die Datenbank antwortet nicht.

Das grenzt die Ursachen auf vier ein. Der schnellste Weg führt in dieser Reihenfolge durch sie hindurch.

Vorab: die Meldung ist nicht immer dieselbe#

Es gibt zwei Varianten, und der Unterschied ist eine Abkürzung.

Nur der eine Satz auf weißem Grund: WordPress kommt nicht an die Datenbank.

Der Satz plus „Eine oder mehrere Datenbanktabellen sind nicht verfügbar. Die Datenbank muss möglicherweise repariert werden": Die Verbindung steht, die Tabellen sind das Problem. Dann kannst du die Punkte 1 bis 3 überspringen und direkt zu Punkt 4.

1. Die Zugangsdaten#

In der wp-config.php stehen vier Werte:

``php define( 'DB_NAME', '...' ); define( 'DB_USER', '...' ); define( 'DB_PASSWORD', '...' ); define( 'DB_HOST', 'localhost' ); ``

Sie müssen exakt zu dem passen, was im Hosting-Panel steht. Die häufigsten Abweichungen:

• DB_HOST ist nicht localhost. Viele Hoster verlangen einen eigenen Servernamen, manchmal mit Port. Das ist der mit Abstand häufigste Fehler nach einem Umzug.
• Der Datenbankname trägt ein Präfix. Bei vielen Anbietern heißt die Datenbank nicht wordpress, sondern d0123456_wordpress. Beim Benutzernamen dasselbe.
• Sonderzeichen im Passwort. Ein Passwort mit $ oder \ in doppelten Anführungszeichen wird von PHP interpretiert. Einfache Anführungszeichen verwenden.

Wann das die Ursache ist: direkt nach einem Umzug oder nachdem jemand am Hosting etwas geändert hat. Lief die Seite gestern noch, ohne dass jemand etwas angefasst hat, ist es Punkt 1 fast nie — siehe WordPress-Migration.

2. Der Datenbankserver antwortet nicht#

Prüfen lässt sich das ohne WordPress. Wenn dein Hoster phpMyAdmin oder Adminer anbietet: dort mit denselben Zugangsdaten anmelden.

• Anmeldung klappt → Zugangsdaten sind richtig, weiter bei Punkt 3.
• Anmeldung klappt nicht → entweder falsche Daten (Punkt 1) oder der Dienst läuft nicht.

Läuft der Dienst nicht, ist das ein Fall für den Hoster. Bei Shared Hosting hast du keine Möglichkeit, ihn neu zu starten, und solltest es auch nicht versuchen.

3. Zu viele Verbindungen#

Das Bild dazu: Die Seite ist mal erreichbar und mal nicht, im Wechsel, ohne dass jemand etwas ändert. Unter Last häufiger als nachts.

Dahinter steht in der Regel ein Verbindungslimit, das ausgeschöpft ist. Ursachen, absteigend nach Häufigkeit:

• Ein Plugin mit teuren Abfragen, das bei jedem Seitenaufruf mehrfach nachfragt.
• Fehlendes Caching — jeder Besucher erzeugt volle Datenbanklast. Was dagegen hilft, steht in WordPress-Geschwindigkeit optimieren.
• Ein Tarif am Anschlag, meist zusammen mit ungewöhnlichem Verkehr.

Ein Hinweis, der oft übersehen wird: Auch ein Bot-Ansturm sieht genau so aus. Bevor du den Tarif vergrößerst, lohnt ein Blick in die Zugriffsprotokolle.

4. Beschädigte Tabellen#

Wenn die zweite Meldungsvariante erscheint, geht es hier weiter.

In der wp-config.php ergänzen, oberhalb von That's all:

``php define( 'WP_ALLOW_REPAIR', true ); ``

Danach deinedomain.de/wp-admin/maint/repair.php aufrufen. Die Seite ist ohne Anmeldung erreichbar — das ist Absicht, weil man sich ja nicht anmelden kann.

Und genau deshalb: Die Zeile sofort danach wieder entfernen. Solange sie steht, kann jeder die Reparatur auslösen.

Zwei Schaltflächen, „Reparieren" reicht meist; „Reparieren und optimieren" dauert länger. Vorher ein Backup ziehen, falls überhaupt noch eines geht.

Wenn nur das Backend betroffen ist#

Läuft die Startseite, aber /wp-admin/ zeigt den Fehler, ist typischerweise die Tabelle wp_options beschädigt. Der Reparaturweg aus Punkt 4 ist dafür der richtige.

Danach#

Die Meldung verschwindet, sobald die Ursache weg ist — ein Neustart hilft nicht, weil nichts hängt.

Wenn du die Ursache nicht findest und die Seite ohne dein Zutun ausgefallen ist, lohnt der Seitenblick: Ungewöhnliche Datenbanklast entsteht auch, wenn jemand anderes die Seite benutzt. Gehackte Website erkennen nennt die Merkmale.