Wie man den „Fehler beim Herstellen einer Datenbankverbindung“ in WordPress behebt

Der „Fehler beim Herstellen einer Datenbankverbindung“ ist wahrscheinlich einer der häufigsten Fehler, die WordPress-Nutzern begegnen können. Er ist eng mit dem „White Screen of Death“ (WSOD) verbunden. Dieser Fehler bedeutet, dass deine Webseite nicht mehr mit deiner WordPress-Datenbank kommuniziert oder auf sie zugreifen kann und somit deine gesamte Webseite ausfällt.

Du solltest diesen Fehler sofort beheben, da er sich direkt auf deine Verkäufe, deinen Traffic und deine Analysen auswirken kann.

Aber keine Sorge, heute besprechen wir einige häufige Ursachen für diesen Fehler und einige einfache Möglichkeiten, wie du deine Webseite in kürzester Zeit wieder zum Laufen bringst.

Schau dir unsere Videoanleitung zur Behebung des „Fehler beim Herstellen einer Datenbankverbindung“ an

So funktioniert es: Alle Informationen auf deiner WordPress-Seite, wie z.B. Beitragsdaten, Seitendaten, Meta-Informationen, Plugin-Einstellungen, Login-Informationen usw., werden in deiner MySQL-Datenbank gespeichert. Die einzigen Daten, die dort nicht gespeichert sind, sind Medieninhalte wie Bilder und deine Theme/Plugin/Core-Dateien wie index.php, wp-login.php usw.

Wenn jemand deine Website besucht, führt PHP den Code auf der Seite aus, fragt die Informationen aus der Datenbank ab und zeigt sie dem Besucher dann in seinem Browser an.

Wenn das nicht richtig funktioniert, bekommst du die Meldung „Fehler beim Herstellen einer Datenbankverbindung“, wie unten zu sehen. Die gesamte Seite ist leer, weil keine Daten abgerufen werden können, um die Seite darzustellen, da die Verbindung nicht richtig funktioniert. Das macht nicht nur das Frontend deiner Seite kaputt, sondern verhindert auch, dass du auf dein WordPress-Dashboard zugreifen kannst.

Es kann jedoch sein, dass Besucher diesen Fehler nicht sofort auf dem Frontend sehen. Das liegt daran, dass deine Webseite höchstwahrscheinlich noch aus dem Cache geladen wird, bis er abläuft. Bei Kinsta zum Beispiel werden alle WordPress-Seiten standardmäßig eine Stunde lang gecached. Wenn eine Webseite also immer noch aus dem Cache geladen wird, kann es sein, dass sie für einen Besucher akzeptabel erscheint.

Bei Kinsta kann unser Support-Team die Dauer des Caches auf eine Stunde oder sogar eine Woche verlängern, wenn du das möchtest. Wenn du eine Webseite hast, die sich nicht sehr oft ändert, kann dies die Leistung deiner Webseite erhöhen, da sie nach Ablauf des Caches nicht so oft neue Dateien abrufen muss. Und in Fällen wie dem oben genannten bleibt das Frontend der Webseite in den meisten Fällen viel länger verfügbar (es sei denn, du hast ein Skript oder einen Teil deiner Webseite, der den Cache zerstört).

Wenn Besucher versuchen, auf deine Webseite zuzugreifen, während dieser Fehler auftritt, wird ein 500 HTTP-Statuscode in deinen Logs angezeigt. Derselbe Statuscode erscheint auch bei einem „internen Serverfehler“ Er bedeutet, dass auf dem Server etwas schief gelaufen ist und die angeforderte Ressource nicht zugestellt werden konnte. Wenn alles ordnungsgemäß funktioniert, erzeugt deine Webseite einen 200 HTTP-Statuscode, was bedeutet, dass alles in Ordnung ist.

Kinsta-Kunden können die Logs ihrer Seite im MyKinsta-Dashboard einsehen:

Wenn du ein Kinsta-Kunde bist, kannst du dir auch den 500-Fehlerbericht in MyKinsta Analytics ansehen, um zu sehen, ob es sich um ein wiederkehrendes Problem handelt.

Was ist die Ursache für den „Fehler beim Herstellen einer Datenbankverbindung“?

Warum genau passiert das? Im Folgenden findest du ein paar häufige Gründe. Und keine Sorge, wir gehen auf jeden dieser Gründe genauer ein, damit du weißt, wie du sie beheben kannst. Normalerweise kannst du diesen Fehler in weniger als 15 Minuten beheben.

Falsche Anmeldedaten für die Datenbank

Deine WordPress-Seite verwendet separate Anmeldeinformationen, um sich mit ihrer MySQL-Datenbank zu verbinden.

Beschädigte Datenbank

Bei so vielen beweglichen Teilen wie Themes, Plugins und Nutzern, die sie ständig löschen und installieren, werden Datenbanken manchmal beschädigt. Das kann an einer fehlenden oder beschädigten Tabelle liegen oder daran, dass einige Informationen versehentlich gelöscht wurden.

Beschädigte Dateien in deiner WordPress-Installation

Das kann sogar manchmal durch Hacker passieren.

Probleme mit deinem Datenbankserver

Auf Seiten des Hosts kann es mehrere Ursachen geben, z. B. eine Überlastung der Datenbank durch eine hohe Anzahl von Verbindungen oder eine mangelnde Reaktionsfähigkeit aufgrund zu vieler gleichzeitiger Verbindungen. Dies ist bei gemeinsam genutzten Hosts häufig der Fall, da sie dieselben Ressourcen für viele Nutzer/innen auf denselben Servern nutzen.

Starker Anstieg des Traffics

Je nachdem, welchen Host du verwendest, kann es sein, dass dein Server nicht in der Lage ist, viele gleichzeitige Datenbankverbindungen zu verarbeiten. Ein Anstieg des Datenverkehrs kann zu vorübergehenden Problemen mit der Datenbank führen.

Wie behebt man den „Fehler beim Herstellen einer Datenbankverbindung“?

Bevor du den Fehler behebst, empfehlen wir dir, ein Backup deiner WordPress-Webseite zu erstellen. Bei vielen der folgenden Empfehlungen werden Informationen in deiner Datenbank manipuliert, du willst also nicht alles noch schlimmer machen. Du solltest immer ein Backup erstellen, bevor du versuchst, Dinge auf deiner WordPress-Webseite zu reparieren, egal wie technisch versiert du zu sein glaubst.

Du kannst ein beliebtes WordPress-Backup-Plugin wie VaultPress oder WP Time Capsule verwenden, um deine Dateien und deine Datenbank zu sichern.

Wenn du ein Kinsta-Benutzer bist, kannst du die Vorteile unserer integrierten Backup-Funktion nutzen. Klicke auf deine WordPress-Seite in MyKinsta und wähle Backups. Klicke dann auf den Reiter Manuell und klicke auf die Schaltfläche Jetzt sichern, um ein manuelles Backup zu erstellen.

Du hast dann auch die Möglichkeit, ein Backup in der Produktion oder im Staging wiederherzustellen. Oder du kannst deine MySQL-Datenbank manuell mit phpMyAdmin sichern. Sobald du ein erfolgreiches Backup erstellt hast, ist es an der Zeit, die Probleme mit der Datenbankverbindung zu beheben.

1. Überprüfe deine Anmeldedaten für die Datenbank

Als Erstes solltest du überprüfen, ob deine Anmeldedaten für die Datenbank korrekt sind. Das ist bei weitem der häufigste Grund, warum die Meldung „Fehler beim Herstellen einer Datenbankverbindung“ auftritt. Vor allem, wenn du zu einem neuen Hosting-Anbieter wechselst. Die Verbindungsdaten für deine WordPress-Webseite sind in der Datei wp-config.php gespeichert, die sich normalerweise im Stammverzeichnis deiner WordPress-Webseite befindet.

Sie enthält vier wichtige Informationen, die korrekt sein müssen, damit die Verbindung erfolgreich hergestellt werden kann.

Datenbankname

// MySQL settings

// The name of the database for WordPress 
define('DB_NAME', 'xxxxxx');

MySQL-Datenbank-Benutzername

// MySQL database username 
define('DB_USER', 'xxxxxx');

MySQL-Datenbank-Passwort

// MySQL database password 
define('DB_PASSWORD', 'xxxxxxxxx');

MySQL-Hostname (Server)

// MySQL hostname 
define('DB_HOST', 'localhost');

Um auf die Datei wp-config.php zuzugreifen, kannst du dich über SFTP mit deiner Webseite verbinden und zum Stammverzeichnis deiner Webseite navigieren. Wenn du das cPanel verwendest, kannst du auf „Dateimanager“ klicken, zum Stammverzeichnis deiner Webseite gehen und mit der rechten Maustaste auf die Datei klicken, um sie zu bearbeiten.

Hier ist ein Beispiel dafür, wie die Datei aussieht, wenn sie geöffnet wird.

Du musst nun deine aktuellen Werte mit denen auf deinem Server abgleichen, um sicherzustellen, dass sie korrekt sind. Befolge die folgenden Anweisungen für cPanel- und Kinsta-Benutzer.

Datenbank-Anmeldeinformationen im cPanel prüfen

Als erstes musst du den Namen der Datenbank überprüfen. Dazu musst du dich in phpMyAdmin im cPanel unter dem Abschnitt Datenbanken anmelden.

Du solltest den Namen deiner Datenbank unten links sehen. Die Datenbank „information_schema“ kannst du ignorieren, da sie vom Hoster verwendet wird. Vergleiche diesen Namen mit dem Wert DB_NAME in deiner wp-config.php-Datei. Wenn sie übereinstimmen, liegt das Problem nicht vor. Wenn sie nicht übereinstimmen, musst du deine wp-config.php-Datei aktualisieren.

Du kannst auch überprüfen, ob es sich um die richtige Datenbank handelt, indem du sicherstellst, dass sie die URL deiner WordPress-Webseite enthält. Dazu klickst du auf die Datenbank und dann auf die Tabelle wp_options (die aus Sicherheitsgründen etwas anders lauten kann, z.B. wpxx_options). Ganz oben in der Tabelle siehst du die Werte für die URL und den Namen deiner Webseite. Wenn diese mit deiner aktuellen Webseite übereinstimmen, kannst du sicher sein, dass du am richtigen Ort bist.

Wenn dein Datenbankname bereits korrekt war und du immer noch die Meldung „Fehler beim Herstellen einer Datenbankverbindung“ erhältst, solltest du auch deinen Benutzernamen und dein Passwort überprüfen. Dazu musst du eine neue PHP-Datei im Stammverzeichnis deiner WordPress-Seite erstellen und den folgenden Code eingeben. Du kannst ihn so nennen, wie du willst, z. B. checkdb.php. Ändere die Werte von db_user und db_password mit denen in deiner wp-config.php Datei.

<?php

$test = mysqli_connect('localhost', 'db_user', 'db_password');
if (!$test) {
    die('MySQL Error: ' . mysqli_error());
}
echo 'Database connection is working properly!';
mysqli_close($testConnection);

Rufe dann die Datei auf deiner WordPress-Seite auf: https://yourdomain.com/checkdb.php. Wenn du einen „MySQL-Fehler: Zugriff verweigert“, dann weißt du, dass dein Benutzername oder dein Passwort falsch ist und du musst mit dem nächsten Schritt fortfahren, um deine Anmeldedaten zurückzusetzen.

Hier ist die Meldung, die du sehen willst: „Die Datenbankverbindung funktioniert ordnungsgemäß.“ Aber wenn das so wäre, wärst du natürlich nicht hier. Achte darauf, dass du diese Datei nach dem Testen löschst/entfernst.

Als Nächstes musst du deinen Benutzernamen und dein Passwort zurücksetzen. Im cPanel klickst du im Bereich Datenbanken auf MySQL-Datenbanken.

Scrolle nach unten und erstelle einen neuen MySQL-Benutzer. Wähle einen eindeutigen Benutzernamen und ein eindeutiges Passwort, damit sie nicht leicht erraten werden können. Der Passwortgenerator, den sie anbieten, funktioniert hervorragend. Klicke dann auf „Benutzer erstellen“. Alternativ kannst du auch das Passwort für den aktuellen Datenbankbenutzer auf diesem Bildschirm ändern.

Scrolle dann nach unten und füge deinen neuen Benutzer zu deiner Datenbank hinzu. Auf dem nächsten Bildschirm wirst du gefragt, welche Rechte du zuweisen möchtest. Wähle „Alle Privilegien“.

Dann nimmst du die neuen Anmeldedaten und aktualisierst deine wp-config.php Datei. Du musst die Werte DB_USER und DB_PASSWORD aktualisieren. Du kannst auch die Testdatei von vorhin noch einmal ausführen. Damit sollte das Problem mit den Zugangsdaten behoben sein. Falls nicht, hast du vielleicht immer noch den falschen Hostnamen (DB_HOST). Einige Hosts verwenden unterschiedliche Werte.

Hier findest du eine Liste mit einigen gängigen DB-Host-Werten. In der Regel ist dies localhost. Du kannst dich aber jederzeit an deinen Hosting-Anbieter wenden oder in seiner Dokumentation nachsehen, wenn du dir nicht sicher bist. Manche verwenden auch 127.0.0.1 anstelle von localhost.

Wenn du alles oben genannte befolgt hast und immer noch die Meldung „Fehler beim Herstellen einer Datenbankverbindung“ erhältst, fahre mit den folgenden Schritten zur Fehlerbehebung fort.

Datenbank-Zugangsdaten mit Kinsta prüfen

Wenn du ein Kinsta-Benutzer bist, ist es viel einfacher, deine Anmeldedaten mit deiner wp-config.php-Datei und dem Server abzugleichen! Du musst im Dashboard von MyKinsta nur auf den Bereich “Info“ deiner Seite klicken, dann siehst du unten den Namen der Datenbank, den Benutzernamen und das Passwort. In der Standardeinstellung verwendet Kinsta localhost als DB_HOST.

Dann nimmst du diese neuen Zugangsdaten und aktualisierst deine wp-config.php Datei. Du musst die Werte DB_USER und DB_PASSWORD aktualisieren. Damit sollte das Problem mit den Zugangsdaten behoben sein. Wenn du die Zugangsdaten zurücksetzen musst, wende dich an unser Support-Team. Wenn du alle oben genannten Schritte befolgt hast und immer noch die Meldung „Fehler beim Herstellen einer Datenbankverbindung“ erhältst, fahre mit den folgenden Schritten zur Fehlerbehebung fort.

2. Beschädigte WordPress Datenbank reparieren

In manchen Fällen kann es sein, dass deine Datenbank beschädigt wurde. Das kann gelegentlich vorkommen (wenn auch nicht sehr oft), da im Laufe der Zeit ständig Hunderte von Tabellen durch neue Plugins und Themes hinzugefügt/entfernt werden. Wenn du versuchst, dich in das Dashboard deiner WordPress-Webseite einzuloggen und die folgende Fehlermeldung erhältst, bedeutet das, dass deine Datenbank beschädigt ist: „Eine oder mehrere Datenbanktabellen sind nicht verfügbar. Die Datenbank muss möglicherweise repariert werden.“ Es ist wichtig zu wissen, dass du diesen Fehler möglicherweise nur im Backend siehst, während du im Frontend die Meldung „Fehler beim Herstellen einer Datenbankverbindung“ siehst.

WordPress verfügt über einen Datenbankreparaturmodus, den du einleiten kannst. Füge das Folgende am Ende deiner wp-config.php-Datei hinzu.

define('WP_ALLOW_REPAIR', true);

Gehe dann zu folgendem Ort auf deiner WordPress-Seite: https://yourdomain.com/wp-admin/maint/repair.php. Du hast dann die Möglichkeit, die Datenbank zu reparieren oder die Datenbank zu reparieren und zu optimieren. Da du wahrscheinlich gerade dabei bist, einen Ausfall deiner Webseite zu beheben, empfehlen wir dir, die Option „Datenbank reparieren“ zu wählen, da sie schneller ist.

Nachdem du die oben beschriebene Reparatur der Datenbank durchgeführt hast, stelle sicher, dass du die Codezeile, die du in deine wp-config.php-Datei eingefügt hast, entfernst. Sonst kann jeder auf die Seite repair.php zugreifen. Wenn du mit cPanel arbeitest, kannst du die Reparatur auch über den Bildschirm MySQL-Datenbanken durchführen.

Du kannst die Reparatur auch von phpMyAdmin aus durchführen. Melde dich einfach in phpMyAdmin an, klicke auf deine Datenbank und wähle alle Tabellen aus. Klicke dann in der Dropdown-Liste auf „Tabelle reparieren“ Damit führst du einfach den Befehl REPAIR TABLE aus.

Die andere Möglichkeit ist, die Reparatur mit WP-CLI mit dem folgenden Befehl auszuführen:

wp db repair

Weitere Informationen zur Verwendung findest du in den WordPress-Entwicklerressourcen.

Wenn du deine Datenbank optimieren möchtest, findest du hier einige gute Anleitungen zur Optimierung von WordPress-Revisionen und zur Konvertierung deiner MyISAM-Tabellen in InnoDB. Wenn du immer noch Probleme mit deiner Webseite hast, fahre mit dem nächsten Schritt zur Fehlerbehebung fort.

Empfohlene Lektüre: So behebst du den Fehler „Der MySQL-Server ist verschwunden“ in WordPress.

3. Beschädigte WordPress-Dateien reparieren

Die folgende mögliche Ursache für die Meldung „Fehler beim Herstellen einer Datenbankverbindung“ ist, dass deine WordPress-Kerndateien beschädigt wurden. Egal, ob dies durch ein Problem bei der Übertragung von Dateien per FTP, durch einen Hacker, der sich Zugang zu deiner Webseite verschafft hat, oder durch ein Problem mit deinem Hoster verursacht wurde, du kannst dies schnell beheben. Wir empfehlen dir jedoch, ein Backup deiner Webseite zu erstellen, bevor du dies versuchst.

Du wirst die Kernversion von WordPress auf deiner Seite ersetzen. Deine Plugins, Themes oder Medien bleiben unangetastet, nur die WordPress-Installation selbst.

Es kann jedoch sein, dass alle Änderungen oder der benutzerdefinierte Code, den du in Dateien wie .htaccess oder wp-config.php hinzugefügt hast, verloren gehen. Wenn du vor der Fehlerbehebung eine Sicherungskopie deiner Webseite erstellt hast, hast du Kopien dieser Dateien, die du später wiederherstellen kannst.

Um loszulegen, musst du eine neue Version von WordPress von WordPress.org herunterladen.

Entpacke diese Datei auf deinem Computer. Darin musst du den Ordner wp-content und die Datei wp-config-sample.php löschen.

Lade dann die verbleibenden Dateien per SFTP auf deine Webseite hoch und überschreibe dabei deine bestehenden Dateien. Dadurch werden alle problematischen Dateien ersetzt und du hast neue, saubere und nicht beschädigte Dateien. Es wird empfohlen, danach den Cache deines Browsers zu löschen. Überprüfe dann deine WordPress-Webseite, um zu sehen, ob der Fehler immer noch besteht.

4. Prüfe, ob es Probleme mit deinem Datenbankserver gibt

Wenn nichts von dem oben Gesagten zur Lösung deines Problems beigetragen hat, empfehlen wir dir, dich an deinen Hosting-Anbieter zu wenden, da es sich um ein Problem mit deinem Datenbankserver handeln könnte. Wenn zum Beispiel zu viele gleichzeitige Verbindungen zu deiner Datenbank bestehen, kann dies zu einem Fehler führen. Das liegt daran, dass viele Hoster die Anzahl der gleichzeitig zulässigen Verbindungen auf ihren Servern begrenzen. Der Einsatz eines Caching-Plugins kann helfen, die Datenbankinteraktionen auf deiner Webseite zu minimieren. Wenn du ein Kinsta-Kunde bist, brauchst du keine Caching-Plugins, denn wir haben ein schnelles Caching auf Serverebene.

Dieses Problem kann bei Shared Hosts häufig auftreten, da theoretisch auch jemand anderes deine Webseite beeinflussen könnte. Das liegt daran, dass bei Shared Hosts alle Ressourcen auf den Servern genutzt werden. Das ist ein weiterer Grund, warum wir einen leistungsstarken Managed WordPress-Host empfehlen, damit die Ressourcen nicht überlastet werden. Das bedeutet auch, dass die Umgebung in der Regel auf die Bewältigung großer Mengen an Datenverkehr, insbesondere für WordPress-Seiten, abgestimmt ist.

Das sachkundige Kinsta-Supportteam ist immer nur einen Klick entfernt und steht dir rund um die Uhr zur Verfügung, wenn du Hilfe brauchst. Und vergiss nicht, dass wir Vertreter haben, die dir in mehreren Sprachen helfen, darunter Englisch, Spanisch, Französisch, Italienisch und Portugiesisch.

5. Letzte Sicherung wiederherstellen

Und zu guter Letzt kannst du bei Bedarf immer auf ein Backup zurückgreifen. In manchen Fällen kann das ein schnellerer Weg sein, um das Problem zu lösen, wenn du dir keine Sorgen machen musst, dass Daten zwischen dem letzten Backup verloren gehen. Viele Anbieter haben ihre eigenen Verfahren zur Wiederherstellung von Backups. Denk daran, dass du möglicherweise sowohl deine Datenbank als auch deine Dateien wiederherstellen musst.

Wenn du ein Kinsta-Benutzer bist, kannst du im Bereich „Backups“ auf deiner Webseite schnell ein Backup deiner Webseite wiederherstellen. Wähle den Zeitpunkt, den du wiederherstellen möchtest, und klicke auf Wiederherstellen bis Dann kannst du auswählen, ob du auf die Staging- oder die Live-Seite wiederherstellen möchtest.

Du wirst dann aufgefordert, die Wiederherstellung zu bestätigen. Gib den Namen deiner Webseite ein und klicke auf „OK“. Bei der Wiederherstellung wird auch ein Backup erstellt, damit du die Wiederherstellung bei Bedarf rückgängig machen kannst.

Zusammenfassung

Wie du siehst, gibt es eine ganze Reihe von Möglichkeiten, den „Fehler beim Herstellen einer Datenbankverbindung“ in WordPress zu beheben. Die häufigste sind ungültige Anmeldedaten in der Datei wp-config.php. Am besten stellst du sicher, dass diese korrekt sind. Das Letzte, was du dir für deine Webseite wünschst, sind Ausfallzeiten.

Hoffentlich hat dir einer der oben genannten Schritte geholfen, deine Webseite wieder zum Laufen zu bringen. Vergiss nicht, dass du deine Webseite bei Bedarf jederzeit von einem Backup wiederherstellen kannst.

Hast du die Meldung „Fehler beim Herstellen einer Datenbankverbindung“ auf deiner Webseite erhalten? Wenn ja, konntest du das Problem beheben? Lass es uns unten in den Kommentaren wissen.

Salman Ravoof

Salman Ravoof ist ein autodidaktischer Webentwickler, Autor, Kreativer und ein großer Bewunderer von Free and Open Source Software (FOSS). Neben Technik begeistert er sich für Wissenschaft, Philosophie, Fotografie, Kunst, Katzen und Essen. Erfahre mehr über ihn auf seiner Website und trete mit Salman auf X in Kontakt.

• Webseite
• LinkedIn
• Twitter