WordPress · Fehlerbehebung
Fehler beim Aufbau einer Datenbankverbindung: was jetzt hilft
Statt Ihrer Website steht nur noch ein Satz auf weißem Grund: Fehler beim Aufbau einer Datenbankverbindung. Es gibt kein Menü und keinen Inhalt, und oft kommen Sie auch nicht mehr ins Backend.
Ihre Inhalte sind in aller Regel nicht weg. WordPress erreicht die Datenbank, in der sie liegen, gerade nicht oder wird dort abgewiesen. Häufig liegt das am Hoster und erledigt sich von selbst, manchmal passen die Zugangsdaten nicht mehr.
Ohne Ihr Zutun: abwarten
Kam die Meldung ohne Ihr Zutun, warten Sie einige Minuten und sehen Sie auf der Statusseite Ihres Hosters nach. Reparieren müssen Sie in diesem Fall selbst nichts.
Nach einem Umzug: Zugangsdaten
Kam sie nach einem Umzug oder einer Passwortänderung, stimmen meist die Zugangsdaten in der Datei wp-config.php nicht mehr.
Keine Neuinstallation
Sichern Sie die wp-config.php, bevor Sie etwas darin ändern. Eine Neuinstallation von WordPress ist in keinem dieser Fälle nötig.
Wie WordPress an seine Inhalte kommt
Eine WordPress-Website besteht aus zwei Teilen. Die Dateien liegen auf dem Webspace, alle Texte, Seiten, Kommentare und Einstellungen dagegen in einer Datenbank. Bei jedem Seitenaufruf meldet sich WordPress mit Benutzername und Passwort bei dieser Datenbank an und holt sich den Inhalt.
Diese Anmeldung ist gescheitert. Entweder antwortet der Datenbankserver nicht, oder er weist WordPress ab. Weil ohne Datenbank nichts da ist, was sich anzeigen ließe, bleibt nur dieser eine Satz.
Woran es meistens liegt
| Wann es passiert | Mögliche Ursache |
|---|---|
| Ohne dass jemand etwas gemacht hat | Der Datenbankserver des Hosters ist überlastet oder kurz ausgefallen. Das kommt vor allem bei Tarifen vor, bei denen sich viele Websites einen Server teilen. |
| Nach einem Umzug oder einer Kopie der Seite | In der Datei wp-config.php stehen noch die Zugangsdaten der alten Umgebung. |
| Nach einem Umzug, obwohl Name, Benutzer und Passwort stimmen | Der Host-Wert passt nicht zum neuen Hoster. Viele Anbieter verwenden statt localhost einen eigenen Servernamen für die Datenbank. |
| Nach einer Passwortänderung beim Hoster | Das Datenbankpasswort wurde geändert, in WordPress steht aber noch das alte. |
| Zugangsdaten sind plötzlich andere, ohne dass jemand sie geändert hat | Dann kann ein Angriff dahinterstecken, bei dem die wp-config.php verändert oder Tabellen gelöscht wurden. Wie Sie dann vorgehen, steht unter Website gehackt: was jetzt zu tun ist. |
| Wenn viele Besucher gleichzeitig auf der Seite sind | Das Paket erlaubt nur eine begrenzte Zahl gleichzeitiger Verbindungen zur Datenbank, und dieses Verbindungslimit ist erreicht. Die Seite fällt dann nur zeitweise aus. |
| Wenn der Speicherplatz knapp wird, oft zusammen mit Fehlern beim Hochladen | Das Speicherplatzlimit des Pakets oder der Datenbank ist erreicht, und der Datenbankserver kann nicht mehr schreiben. |
Schritt für Schritt eingrenzen
- Prüfen Sie, ob auch das Backend betroffen ist. Rufen Sie Ihre Adresse mit dem Zusatz /wp-admin auf. Erscheint dort dieselbe Meldung, betrifft es die ganze Installation. Erscheint eine andere Meldung, etwa dass die Datenbank repariert werden muss, ist das ein anderer Fall.
- Laden Sie die Seite nach einigen Minuten neu. Kam die Meldung ohne Änderung an der Website, ist es häufig eine kurze Überlastung. Verschwindet sie von selbst wieder, lag es am Server.
- Sehen Sie auf der Statusseite Ihres Hosters nach. Die meisten Anbieter melden Störungen dort oder auf ihren Social-Media-Kanälen. Ist eine Störung gemeldet, bleibt Ihnen nur abzuwarten.
- Vergleichen Sie die Zugangsdaten. In der Datei wp-config.php im Hauptverzeichnis stehen vier Werte: Datenbankname, Benutzer, Passwort und Host. Diese müssen exakt zu dem passen, was im Kundenmenü Ihres Hosters bei der Datenbank steht. Laden Sie die Datei vor jeder Änderung herunter, damit Sie zurück können.
- Testen Sie die Zugangsdaten im Datenbank-Werkzeug des Hosters. Fast jeder Hoster bietet im Kundenmenü ein Werkzeug an, mit dem Sie die Datenbank im Browser öffnen, meist phpMyAdmin. Melden Sie sich dort mit Benutzer und Passwort aus der wp-config.php an, nicht über eine automatische Anmeldung aus dem Kundenmenü, denn die sagt nichts über die Werte in der Datei aus. Klappt die Anmeldung nicht, stimmen Benutzer oder Passwort nicht. Dann setzen Sie im Kundenmenü ein neues Passwort für den Datenbankbenutzer und tragen es in die wp-config.php ein. Klappt sie, sehen Sie nach, ob es die Datenbank mit dem Namen aus der Datei gibt und ob darin Tabellen liegen. Ist das der Fall, liegt es am Host-Wert oder am Server selbst.
- Fragen Sie beim Hoster nach. Wenn die Zugangsdaten stimmen und die Seite weiter nicht läuft, formulieren Sie es konkret: Die Datenbank nimmt keine Verbindung an, bitte prüfen Sie, ob der Datenbankserver läuft und ob mein Paket ein Speicher- oder Verbindungslimit erreicht hat.
Bei den Seiten, die ich betreue, war in den meisten Fällen eine kurze Störung beim Hoster die Ursache, und die Seite lief nach einer Weile von allein wieder.
Nach einem Umzug: Host-Wert und Tabellenpräfix
Der vierte Wert in der wp-config.php, DB_HOST, lautet nicht bei jedem Hoster localhost. Viele Anbieter nennen einen eigenen Servernamen für die Datenbank, manchmal mit einer Portnummer dahinter. Der richtige Wert steht im Kundenmenü bei den Angaben zur Datenbank. Nach einem Umzug ist ein alter Host-Wert einer der häufigsten Gründe für diese Meldung.
Zeigt die Seite nach dem Umzug statt der Meldung plötzlich die Einrichtung einer neuen WordPress-Installation, verbindet sich WordPress zwar, findet aber keine Inhalte. Entweder ist die Datenbank leer, weil der Import nicht geklappt hat, oder das Tabellenpräfix passt nicht. Das Präfix steht in der wp-config.php bei $table_prefix und muss mit dem Anfang der Tabellennamen in der Datenbank übereinstimmen, zum Beispiel wp_. Durchlaufen Sie die Einrichtung in diesem Fall nicht, sonst entsteht eine zweite, leere Website.
Im Netz kursiert der Tipp, in der wp-config.php die Zeile mit WP_ALLOW_REPAIR einzufügen und die Reparaturseite aufzurufen. Das hilft nur bei beschädigten Tabellen. Bei einem Verbindungsproblem bewirkt es nichts, und die Reparaturseite ist danach ohne Anmeldung für jeden erreichbar. Wenn Sie sie nutzen, entfernen Sie die Zeile sofort danach wieder.
Was jetzt nicht hilft
- Eine neue Datenbank anlegen oder WordPress neu installieren: Dann haben Sie eine leere Installation, während Ihre Inhalte in der alten Datenbank liegen bleiben.
- Plugins löschen: WordPress kommt bei diesem Fehler gar nicht erst bis zu den Plugins.
- Die wp-config.php ohne Kopie bearbeiten: Nach einem Tippfehler haben Sie schnell ein zweites Problem.
Wenn die Datenbank beschädigt ist
Selten steckt eine defekte Tabelle dahinter, meist nach einem abgebrochenen Update oder bei vollem Speicher. Dann meldet WordPress meist ausdrücklich, dass eine Datenbanktabelle repariert werden muss. Ziehen Sie in dem Fall erst eine Sicherung der Datenbank und reparieren Sie danach. Ohne Sicherung kann eine Reparatur Daten kosten.
Dafür brauchen Sie ein Backup, das nicht auf demselben Server liegt. Worauf es dabei ankommt, steht unter WordPress-Backups.
Hier endet, was sich gefahrlos selbst erledigen lässt. Ist die Datenbank leer, fehlen Tabellen, wurden Zugangsdaten ohne Ihr Wissen geändert oder hängt ein Shop mit Bestellungen an der Seite, kann jeder weitere Versuch Daten kosten, die sich ohne Sicherung nicht zurückholen lassen. Dann schreiben Sie mir besser über die Kontaktseite, bevor Sie in der Datenbank etwas verändern.
Häufige Fragen
Sind meine Inhalte verloren?
Meistens nicht. Die Meldung bedeutet nur, dass WordPress die Datenbank gerade nicht erreicht, an den Daten darin ändert das nichts. Ernster wird es erst bei einer beschädigten Tabelle oder wenn die Zugangsdaten ohne Ihr Wissen geändert wurden. Dann kann ein Angriff dahinterstecken, mehr dazu unter Website gehackt.
Wann ist die Seite wieder erreichbar?
Liegt die Störung beim Hoster, hängt die Dauer an ihm, und meistens ist sie nach kurzer Zeit vorbei. Stimmen nur die Zugangsdaten nicht, ist die Seite wieder da, sobald die richtigen Werte eingetragen sind. Mehr Zeit braucht es, wenn Tabellen beschädigt sind und erst eine Sicherung gezogen werden muss.
Taucht die Meldung wieder auf?
Eine einmalige Störung beim Hoster muss sich nicht wiederholen. Taucht die Meldung dagegen immer wieder auf, stößt die Seite meist an eine Grenze ihres Pakets, und das legt sich nicht von allein. Dann lohnt sich ein Blick darauf, was den Server so stark beschäftigt und ob das Paket noch zur Seite passt.
Hilfe anfragen
Die Seite ist noch immer nicht erreichbar?
Meldet Ihr Hoster keine Störung und stimmen die Zugangsdaten, liegt die Ursache meist etwas tiefer, zum Beispiel bei den Rechten des Datenbankbenutzers oder einer beschädigten Tabelle. Schicken Sie mir die Adresse und eine kurze Notiz, was zuletzt an der Seite gemacht wurde. Ich sehe mir Datenbank und Konfiguration an und nenne Ihnen den Aufwand, bevor ich etwas verändere.
Kommt der Fehler immer wieder: In jedem Paket wird die Erreichbarkeit täglich geprüft, sodass ein Ausfall nicht tagelang unbemerkt bleibt.
Weitere Anleitungen und Einschätzungen finden Sie im Ratgeber.
