Fehler beim Aufbau einer Datenbankverbindung beheben
Fehler beim Aufbau einer Datenbankverbindung in WordPress? Prüfen Sie wp-config.php, testen Sie den Login, starten Sie MariaDB und reparieren Sie Tabellen.

Inhalt
- Was bedeutet der Fehler?
- Die Angaben in der wp-config.php prüfen
- Den Datenbank-Login testen
- Läuft der Datenbankserver?
- Beschädigte Tabellen reparieren
- DB_HOST: localhost, 127.0.0.1 oder Socket
- Nach einem Umzug
- Zu viele Verbindungen
- Könnte die Website gehackt sein?
- Wo Sie in den Logs nachsehen
- WordPress-Datenbanken bei Nodesty
Der Fehler beim Aufbau einer Datenbankverbindung gehört zu den beunruhigendsten WordPress-Fehlern, denn die gesamte Website verschwindet hinter einer einzigen weißen Seite. Die gute Nachricht: Die Inhalte sind meist noch da. WordPress erreicht lediglich seine MySQL- oder MariaDB-Datenbank nicht, und die Ursache ist fast immer eine von wenigen Möglichkeiten.
In dieser Anleitung zeigen wir, was die Meldung bedeutet, wie Sie die Angaben in der wp-config.php prüfen und den Datenbank-Login testen, was bei einem gestoppten Datenbankserver zu tun ist, wie Sie beschädigte Tabellen reparieren, welche Einstellungen nach einem Umzug brechen, was es mit Verbindungslimits auf sich hat und wo Sie in den Logs nachsehen.
Was bedeutet der Fehler?
WordPress speichert alles außer Mediendateien in einer Datenbank: Beiträge, Seiten, Benutzer, Einstellungen und Plugin-Daten. Bei jedem Seitenaufruf verbindet sich PHP mit den Angaben aus der wp-config.php mit der Datenbank. Schlägt diese Verbindung fehl, bricht WordPress ab und zeigt diese Meldung. Auf englischsprachigen Websites lautet derselbe Fehler „Error establishing a database connection“.
Die häufigsten Ursachen:
| Ursache | Typisches Anzeichen |
|---|---|
| Falsche Angaben in der wp-config.php | Fehler direkt nach einem Umzug oder einer Passwortänderung |
| Datenbankserver gestoppt | Alle Websites auf dem Server zeigen den Fehler |
| Beschädigte Tabellen | wp-admin meldet nicht verfügbare, zu reparierende Tabellen |
| Verbindungs- oder Speicherlimits | Fehler kommt und geht, meist zu Stoßzeiten |
| Gehackte Website | Fehler taucht auf, ohne dass jemand etwas geändert hat |
Die Angaben in der wp-config.php prüfen
Öffnen Sie die wp-config.php im Stammordner Ihrer Website (meist public_html) mit dem Dateimanager des Control Panels oder per SFTP und suchen Sie diese Zeilen:
define( 'DB_NAME', 'cpuser_wp123' );
define( 'DB_USER', 'cpuser_wpuser' );
define( 'DB_PASSWORD', 'sicheres-passwort' );
define( 'DB_HOST', 'localhost' );
Vergleichen Sie jeden Wert mit der tatsächlich vorhandenen Datenbank. In cPanel und DirectAdmin beginnen Datenbank- und Benutzernamen mit Ihrem Kontonamen und einem Unterstrich, etwa cpuser_wp123; das Präfix zu vergessen, ist nach einem Umzug ein häufiger Fehler. Prüfen Sie außerdem, dass das Passwort am Anfang oder Ende kein überzähliges Leerzeichen enthält und ein einfaches Anführungszeichen im Passwort als \' geschrieben ist.
Den Datenbank-Login testen
Raten Sie nicht, ob die Angaben stimmen, sondern testen Sie sie. Per SSH mit den Angaben aus der wp-config.php:
mysql -u cpuser_wpuser -p -h localhost cpuser_wp123
Erscheint die Eingabeaufforderung MariaDB [cpuser_wp123]>, sind die Angaben korrekt. Access denied for user bedeutet, dass Benutzername oder Passwort falsch sind, Unknown database, dass der Datenbankname falsch ist. Eine Meldung wie Can't connect to local server through socket (bei MySQL leicht anders formuliert) zeigt, dass der Datenbankserver nicht läuft oder an einer anderen Stelle lauscht.
Ohne SSH-Zugang nutzen Sie das Panel: Prüfen Sie in cPanel unter MySQL Databases (in DirectAdmin unter MySQL Management), ob die Datenbank existiert und der Benutzer ihr mit allen Rechten zugewiesen ist, und vergeben Sie bei Bedarf ein neues Passwort. Tragen Sie dasselbe Passwort anschließend in die wp-config.php ein. Die Tabellen sehen Sie, wenn Sie die Datenbank in phpMyAdmin öffnen.
Läuft der Datenbankserver?
Zeigen alle Websites auf dem Server gleichzeitig den Fehler, ist vermutlich der Datenbankserver selbst gestoppt. Beim Shared Hosting wenden Sie sich an Ihren Anbieter; auf Ihrem eigenen vServer prüfen Sie ihn so:
sudo systemctl status mariadb
sudo journalctl -u mariadb --since "1 hour ago"
Nutzen Sie MySQL statt MariaDB, heißt der Dienst unter Ubuntu/Debian mysql und unter AlmaLinux mysqld. Neu starten können Sie ihn mit:
sudo systemctl restart mariadb
Startet der Dienst nicht oder stoppt er immer wieder, suchen Sie die Ursache, statt ihn wieder und wieder neu zu starten. Die zwei häufigsten:
- Die Festplatte ist voll. MariaDB kann seine Daten- und Logdateien nicht schreiben und bleibt stehen. Prüfen Sie das mit
df -h; wie Sie Platz schaffen, zeigt unsere Anleitung Linux Festplatte voll. - Der Arbeitsspeicher ist erschöpft. Geht der RAM aus, beendet der OOM-Killer des Kernels oft den größten Prozess, und das ist meist die Datenbank. Sie sehen das im Kernel-Log:
sudo journalctl -k | grep -i "out of memory"
Geht der Speicher regelmäßig aus, verkleinern Sie innodb_buffer_pool_size, richten Sie Swap ein oder wechseln Sie auf einen Tarif mit mehr RAM. Installation und Konfiguration des Datenbankservers behandeln wir in MariaDB installieren.
Beschädigte Tabellen reparieren
Funktioniert der Login und läuft der Server, WordPress meldet aber trotzdem einen Fehler, oder zeigt /wp-admin „One or more database tables are unavailable“ (eine oder mehrere Datenbanktabellen sind nicht verfügbar), sind einzelne Tabellen beschädigt. Sichern Sie zuerst die Datenbank und fügen Sie dann diese Zeile in der wp-config.php oberhalb der Zeile /* That's all, stop editing! */ ein:
define( 'WP_ALLOW_REPAIR', true );
Öffnen Sie anschließend https://ihredomain.de/wp-admin/maint/repair.php und wählen Sie Datenbank reparieren. Diese Seite ist ohne Anmeldung erreichbar, deshalb gilt: Entfernen Sie die Zeile aus der wp-config.php, sobald die Reparatur abgeschlossen ist.
Mit SSH-Zugang erledigen Sie dasselbe mit mysqlcheck oder WP-CLI:
mysqlcheck -u cpuser_wpuser -p --auto-repair cpuser_wp123
wp db repair
DB_HOST: localhost, 127.0.0.1 oder Socket
DB_HOST lautet bei fast jedem Hosting-Tarif localhost. Auf dem eigenen Server spielt der Unterschied eine Rolle:
localhost: PHP verbindet sich über den lokalen Unix-Socket.127.0.0.1: PHP verbindet sich per TCP, meist über Port 3306. Den Port können Sie anhängen:127.0.0.1:3306.- Ein Socket-Pfad:
localhost:/run/mysqld/mysqld.sock, wenn der Socket nicht dort liegt, wo PHP ihn erwartet.
Schlägt localhost fehl, versuchen Sie 127.0.0.1 und umgekehrt. Läuft die Datenbank auf einem anderen Server, tragen Sie dessen Adresse ein und prüfen Sie, dass sich der Datenbankbenutzer von der IP Ihres Webservers aus verbinden darf und die Firewall Port 3306 nur von dort freigibt.
Nach einem Umzug
Die meisten dieser Fehler treten direkt nach einem Website-Umzug auf. Prüfen Sie diese Punkte:
- Neue Zugangsdaten: Datenbankname, Benutzer und Passwort beim neuen Anbieter sind fast nie dieselben wie beim alten. Aktualisieren Sie alle vier Zeilen in der
wp-config.php. - Wurde die Datenbank importiert? Öffnen Sie die Datenbank in phpMyAdmin und vergewissern Sie sich, dass die Tabellen vorhanden sind.
- Tabellenpräfix:
$table_prefixin derwp-config.phpmuss zum Präfix der importierten Tabellen passen, etwawp_oderwpab_. Andernfalls zeigt WordPress meist den Installationsbildschirm statt Ihrer Website. - siteurl und home: Hat sich die Domain geändert, schickt die alte Adresse in der Tabelle
wp_optionsBesucher zur alten Website zurück. Vorübergehend können Sie das in derwp-config.phpkorrigieren:
define( 'WP_HOME', 'https://ihredomain.de' );
define( 'WP_SITEURL', 'https://ihredomain.de' );
Den gesamten Ablauf beschreiben wir Schritt für Schritt in Website umziehen.
Zu viele Verbindungen
Kommt und geht der Fehler, lehnt die Datenbank womöglich neue Verbindungen ab. In den Logs sehen Sie dann Too many connections (das serverweite Limit max_connections) oder has exceeded the 'max_user_connections' resource (ein Limit pro Benutzer, beim Shared Hosting verbreitet). Auf dem eigenen Server prüfen Sie das Limit und die offenen Verbindungen so:
SHOW VARIABLES LIKE 'max_connections';
SHOW FULL PROCESSLIST;
Das Limit anzuheben, behandelt nur das Symptom. Meist stecken langsame Abfragen, ein Plugin, das viele Verbindungen öffnet, oder Bot-Traffic ohne Caching dahinter. Ein Seiten-Cache wie LiteSpeed Cache senkt die Zahl der Datenbankabfragen deutlich.
Könnte die Website gehackt sein?
Hat niemand etwas geändert und der Fehler taucht aus heiterem Himmel auf, denken Sie an einen Angriff. Schadcode verändert manchmal die wp-config.php, und ein Angreifer mit Panel-Zugang kann das Datenbankpasswort ändern oder Tabellen löschen. Prüfen Sie, wann die Datei geändert wurde:
ls -l --time-style=long-iso wp-config.php
Passt das Datum zu keiner Ihrer Änderungen, folgen Sie unserer Anleitung Website gehackt, bevor Sie einfach die Zugangsdaten wiederherstellen.
Wo Sie in den Logs nachsehen
- WordPress: Setzen Sie
define( 'WP_DEBUG', true );unddefine( 'WP_DEBUG_LOG', true );in derwp-config.php, dann landen Fehler inwp-content/debug.log. Schalten Sie beides danach wieder ab. - PHP: cPanel zeigt die Datei
error_logim Website-Ordner und die Seite Errors; DirectAdmin bietet das Fehlerprotokoll der Domain im Panel an. - MariaDB/MySQL: Je nach Konfiguration
journalctl -u mariadb, unter Ubuntu/Debian/var/log/mysql/error.logund unter AlmaLinux/var/log/mariadb/mariadb.log.
Zeigt der Browser statt dieser Meldung einen 500-Fehler, liegt das Problem eher bei PHP als bei der Datenbank; den Unterschied erklärt unsere Übersicht HTTP-Fehlercodes.
WordPress-Datenbanken bei Nodesty
Das Webhosting von Nodesty betreibt WordPress-Websites auf Servern mit AMD Ryzen 9 7900, dem Webserver LiteSpeed und NVMe-Speicher. Datenbanken und Benutzer verwalten Sie mit cPanel oder DirectAdmin und phpMyAdmin, und über JetBackup stellen Sie eine Datenbank direkt im Panel wieder her. Möchten Sie MariaDB selbst verwalten, bieten unsere AMD Ryzen 9 9950X vServer vollen Root-Zugriff und kostenlose tägliche Backups mit 7 Tagen Aufbewahrung.
Häufig gestellte Fragen
Was bedeutet Fehler beim Aufbau einer Datenbankverbindung?
WordPress speichert Beiträge, Seiten, Benutzer und Einstellungen in einer MySQL- oder MariaDB-Datenbank. Die Meldung bedeutet, dass PHP keine Verbindung zu dieser Datenbank herstellen konnte und WordPress daher nichts anzeigen kann. Die Ursache sind fast immer falsche Angaben in der wp-config.php, ein gestoppter Datenbankserver oder eine Datenbank, die an ein Limit gestoßen ist.
Sind meine Beiträge und Seiten verloren?
In der Regel nicht. Der Fehler bedeutet, dass WordPress die Datenbank nicht erreicht, nicht dass die Daten weg sind. Sobald die Zugangsdaten stimmen oder der Datenbankserver wieder läuft, ist die Website wie vorher erreichbar. Sichern Sie die Datenbank trotzdem, bevor Sie Tabellen reparieren oder etwas ändern.
Die Website zeigt den Fehler, aber wp-admin funktioniert. Wie kann das sein?
Meldet wp-admin, dass eine oder mehrere Datenbanktabellen nicht verfügbar sind, sind einzelne Tabellen beschädigt. Aktivieren Sie WP_ALLOW_REPAIR in der wp-config.php, starten Sie die Reparatur unter /wp-admin/maint/repair.php und entfernen Sie die Zeile danach wieder.
Gehört in DB_HOST localhost oder 127.0.0.1?
Bei den meisten Hosting-Tarifen ist es localhost. localhost verbindet sich über den lokalen Unix-Socket, 127.0.0.1 per TCP über Port 3306. Funktioniert das eine nicht, probieren Sie das andere; liegt die Datenbank auf einem anderen Server, tragen Sie dessen Adresse ein und stellen Sie sicher, dass der Benutzer sich von Ihrem Webserver aus verbinden darf.
Warum tritt der Fehler nur zu Stoßzeiten auf?
Der Datenbank gehen möglicherweise die Verbindungen oder der Arbeitsspeicher aus. Zu viele Verbindungen, ein max_user_connections-Limit für den Datenbankbenutzer oder ein MariaDB-Prozess, den der Kernel wegen Speichermangels beendet, führen unter Last zu Fehlern. Caching, weniger schwere Plugins oder mehr Ressourcen lösen das dauerhaft.
Kann eine gehackte Website diesen Fehler auslösen?
Ja. Schadcode verändert manchmal die wp-config.php, oder ein Angreifer ändert das Passwort des Datenbankbenutzers oder löscht Tabellen. Haben Sie nichts geändert und die Zugangsdaten funktionieren plötzlich nicht mehr, prüfen Sie, wann die wp-config.php zuletzt geändert wurde, und scannen Sie die Website auf Schadsoftware.
Über den Autor
Nodesty-Team · Infrastruktur und Support
Das Nodesty-Team betreibt unsere Server, unser Netzwerk und unseren DDoS-Schutz im Alltag und beantwortet Support-Anfragen rund um die Uhr. Diese Ratgeber entstehen aus dieser Arbeit.
Verwandte Artikel

WordPress Upload-Limit erhöhen: upload_max_filesize anpassen
WordPress Upload-Limit erhöhen: So beheben Sie den Fehler upload_max_filesize in cPanel, DirectAdmin, per .user.ini, .htaccess oder auf dem eigenen Server.

502 Bad Gateway: Ursachen und Lösungen für Nginx
502 Bad Gateway? So lesen Sie das Nginx-Fehlerlog, starten PHP-FPM oder Ihre App, korrigieren Port oder Socket, erhöhen pm.max_children, prüfen Cloudflare.

WordPress Passwort zurücksetzen: So kommen Sie wieder rein
Kein Zugang zu WordPress? Setzen Sie das Admin-Passwort per Passwort-vergessen-Link, WP-CLI, phpMyAdmin oder MySQL zurück oder legen Sie einen Admin an.