Fehler beim Aufbau einer Datenbankverbindung beheben

Kategorie: Maschinenraum

Ob während der Installation oder später im laufenden Betrieb: die Fehlermeldung "Fehler beim Aufbau einer Datenbankverbindung" ist nicht unüblich. Dies heißt aber keinesfalls, dass Du Deinen Blog neu aufsetzen musst. Hier zeigen wir Dir, wie Du dieses Problem beheben kannst.

Mögliche Ursachen des Fehlers

Damit Dein WordPress Blog problemlos läuft benötigt er eine Datenbank. Wenn die Verbindung zu dieser Datenbank nicht hergestellt werden kann, wird anstelle Deines Blogs der oben genannte Fehler im Browser angezeigt. Da es verschiedene Ursachen für dieses Problem geben kann, musst Du erst die Gründe dafür eingrenzen.

Teste zuerst, ob der Fehler beim Aufbau der Datenbankverbindung sowohl auf der Startseite als auch im Adminbereich angegeben wird. Wenn Du im WP-Admin eine andere Fehlermeldung siehst, ist Deine Datenbank beschädigt. Dies kann z.B. passieren, wenn gerade ein Datenbankeintrag geschrieben wird, während die Verbindung zu einem Besucher abbricht.

Beschädigte Datenbank reparieren

Ist Deine Datenbank beschädigt, hast Du zwei Möglichkeiten sie zu reparieren:

In dem von Deinem Webhoster zur Verfügung gestellten Datenbanktool (meist phpMyAdmin) wählst Du dafür die Tabellen der Datenbank aus und klickst anschließend auf "Repariere Tabelle".

Alternativ fügst Du diese Zeile in die wp-config.php ein (siehe unsere Artikel zu dem Bearbeiten von Dateien und zur wp-config.php):

define('WP\_ALLOW\_REPAIR', true);

Dadurch repariert WordPress die Tabellen der Datenbank für Dich. Unter

http://deinedomain.de/wp-admin/maint/repair.php

kannst Du die Einstellungen dafür aufrufen.

Achtung: So lange der Eintrag in der wp-config.php steht, kann jeder Nutzer auch ohne angemeldet zu sein auf diese Seite gelangen! Denke unbedingt daran, die Zeile wieder aus der Datei zu löschen, wenn die Datenbank repariert ist.

Falsche Angaben in der wp-config.php

Der Fehler beim Aufbau der Datenbankverbindung kann auch auftreten, wenn in der wp-config.php die falschen Zugangsdaten gespeichert sind. Dies geschieht z.B., wenn Du das Passwort für Deine Datenbank änderst und keine Anpassung in der wp-config.php Datei vornimmst. Oder Du Deinen Webhostinganbieter gewechselt hast und vergisst die neuen Daten einzutragen. In diesem Fall ist der Fehler sehr einfach zu beheben. Überprüfe dafür diese Einträge in Deiner wp-config.php und korrigiere sie wenn nötig:

define('DB_NAME', 'Der Name Deiner Datenbank');
define('DB_USER', 'Dein Datenbank-Benutzername');
define('DB_PASSWORD', 'Dein Datenbank-Passwort');
define('DB_HOST', 'Die von Deinem Provider zugewiesene Serveradresse');

Der Wert für DB_HOST lautet meistens localhost.

Wichtig: Prüfe genau die Schreibweise. Es können leicht Zeichen wie z.B. Null und der Buchstabe O oder ein kleines L mit der 1 oder dem großen i verwechselt werden. Es kann sich auch ein Leerzeichen beim Einfügen des Passwortes eingeschlichen haben. Außerdem müssen die Hochkomma-Zeichen ' vor und nach den Variablen und Werten stehen und dürfen keinesfalls mit dem Gravis ` oder Akzent-Zeichen ´ vertauscht werden.

Datenbank existiert nicht

Ein Fehler beim Aufbau der Datenbankverbindung kann auch entstehen, wenn die Datenbank nicht existiert oder nicht alle nötigen Tabellen enthält. Dazu kann es z.B. kommen, wenn Du Deinen Blog zu einem anderen Webhostinganbieter umziehst und die alte Datenbank nicht korrekt importiert wurde. Auch hier hilft Dir das Datenbanktool Deines Anbieters. Prüfe damit, ob die Datenbank existiert und den richtigen Inhalt hat. Liegt hier die Ursache für die Fehlermeldung, importiere die Datenbank erneut.

Datenbankserver ist nicht erreichbar

Wenn die oben aufgeführten möglichen Ursachen nicht auf Dich zutreffen kann es sein, dass Dein Datenbankserver nicht erreichbar ist. Um dies zu überprüfen, stehen Dir verschiedene Optionen offen. Die einfachste ist, andere Seiten auf demselben Server aufzurufen. Wird auch hier die Fehlermeldung angezeigt, ist der MySQL-Server das Problem.

Wenn Du keine anderen Seiten auf dem Server hast, verbinde Dich über phpMyAdmin mit der Datenbank. Falls die Verbindung gelingt, ist der nächste Schritt zu überprüfen, ob Dein Datenbankbenutzer die korrekten Rechte für den Zugriff auf die Datenbank hat.

Hierfür erstellst Du mit Hilfe eines Texteditors eine neue Datei verbindungstest.php und setze den folgenden Code ein, wobei Du Datenbanknutzername und Datanbankpasswort durch Deine passenden Werte ersetzt:

<?php
$link = mysql_connect('localhost', 'Datenbanknutzername', 'Datenbankpasswort');
if (!$link) {
die('Konnte keine Verbindung aufbauen: ' . mysql_error());
}
echo 'Erfolgreich mit der Datenbank verbunden';
mysql_close($link);
?>

Die neue Datei lädst Du per FTP hoch und rufst diese über den Browser auf:

http://deinedomain.de/verbindungstest.php

Wenn die Verbindung glückt bedeutet dies, dass der Fehler nicht in der Datenbank liegt. Überprüfe erneut die wp-config.php, z.B. auf Schreibfehler. Kannst Du keine Verbindung herstellen, ist der Server die Ursache der Fehlermeldung. Kontaktiere in diesem Fall Deinen Webhostinganbieter, damit dieser die Ursache beseitigen kann.

Denk daran die Datei verbindungstest.php anschließend wieder zu löschen.


Dir hat der Artikel geholfen und du möchtest mit unseren WordPress Tipps, Tricks und Anleitungen auf dem Laufenden bleiben? Dann trag dich einfach in unseren kostenlosen Newsletter ein ...


Über den Autor

Nils Schulte am Hülse

Ich arbeite seit über 15 Jahren aktiv mit WordPress und gleichzeitig als Trainer für Präsentation und Kommunikation. Daher liegt mir das Thema verständliche Informationsvermittlung sehr am Herzen. Genau dieses Know How ist auch in den gemeinsam mit Frank erstellten WP ohne Stress Online Kurs eingeflossen.


Diese Beiträge könnten dir auch gefallen

Welchen WordPress Webhoster wählen?

Welchen WordPress Webhoster wählen?

WordPress: Vorteile und Nachteile

WordPress: Vorteile und Nachteile
{"email":"Email address invalid","url":"Website address invalid","required":"Required field missing"}
>