So beheben Sie den Fehler „Verbindung zur Datenbank konnte nicht hergestellt werden“ in Joomla 6

Die Fehlermeldung "Verbindung zur Datenbank konnte nicht hergestellt werden" bedeutet, dass Joomla 6 keine Verbindung zur MySQL- oder MariaDB-Datenbank herstellen kann.

Joomla speichert fast alle Website-Daten in der Datenbank, darunter Artikel, Benutzer, Erweiterungen, Konfigurationseinstellungen und Menüpunkte. Wenn die Datenbankverbindung ausfällt, ist die Website in der Regel nicht mehr erreichbar, und auch der Administrationsbereich funktioniert möglicherweise nicht mehr.

Dieser Fehler wird in der Regel durch eine der folgenden Ursachen ausgelöst:

Falsche Datenbank-Anmeldedaten
Falscher Datenbank-Hostname
Fehlende Datenbankberechtigungen
MySQL- oder MariaDB-Server nicht verfügbar
Falsche PHP-Konfiguration
Serverseitige Einschränkungen

In dieser Anleitung wird Schritt für Schritt erklärt, wie Sie das Problem diagnostizieren und beheben können.

1. Überprüfen Sie die Konfiguration der Joomla-Datenbank

Als Erstes sollten Sie die Joomla-Konfigurationsdatei überprüfen.

Die Datei befindet sich im Stammverzeichnis von Joomla:

/configuration.php

Öffnen Sie die Datei über FTP, SSH oder den Dateimanager Ihres Hosting-Anbieters.

Suchen Sie folgende Datenbankeinstellungen:

public $host = 'localhost';
public $user = 'database_username';
public $password = 'database_password';
public $db = 'database_name';

Stellen Sie sicher, dass jeder Wert mit den von Ihrem Hosting-Anbieter bereitgestellten Datenbankdaten übereinstimmt.

Überprüfen Sie den Hostnamen der Datenbank

Der häufigste Wert ist:

localhost

Einige Hosting-Anbieter verwenden jedoch einen separaten Datenbankserver, zum Beispiel:

mysql.example.com
db123.hosting-provider.com

Wenn der Hostname falsch ist, kann Joomla keine Verbindung herstellen, selbst wenn Benutzername und Passwort korrekt sind.

Den korrekten Hostnamen der Datenbank finden Sie in der Regel in:

Ihrem Hosting-Control-Panel
Bereich Datenbankverwaltung
Dokumentation zur Einrichtung des Hostings

2. Überprüfen Sie den Benutzernamen und das Passwort für die Datenbank

Eine sehr häufige Ursache für diesen Fehler ist ein geändertes Datenbankpasswort.

Wenn Sie beispielsweise das Datenbankpasswort in Ihrem Hosting-Control-Panel geändert, aber Joomla nicht aktualisiert haben, stimmen die Werte nicht mehr überein.

Überprüfen Sie:

public $user = 'database_username';
public $password = 'database_password';

Stellen Sie sicher, dass:

Der Datenbanknutzer existiert
Das Passwort korrekt ist
Vor und nach den Werten befinden sich keine zusätzlichen Leerzeichen

Falls Sie sich bezüglich des Passworts unsicher sind, setzen Sie es bitte in Ihrem Hosting-Control-Panel zurück und aktualisieren Sie die Datei configuration.php.

3. Testen Sie die Datenbank mit phpMyAdmin

Um festzustellen, ob das Problem bei Joomla oder beim Datenbankserver liegt, testen Sie die Datenbank direkt.

Melden Sie sich bei Ihrem Hosting-Control-Panel an und öffnen Sie:

phpMyAdmin

Versuchen Sie, die Joomla-Datenbank zu öffnen.

Falls phpMyAdmin funktioniert:

Der Datenbankserver läuft
Die Datenbank existiert
Das Problem liegt wahrscheinlich in der Joomla-Konfiguration

Falls phpMyAdmin keine Verbindung herstellen kann:

Der Datenbankserver ist möglicherweise nicht verfügbar
Der Datenbanknutzer verfügt möglicherweise über falsche Berechtigungen
Beim Hosting-Anbieter liegt möglicherweise ein Problem vor

4. Datenbank-Nutzerberechtigungen überprüfen

Der in Joomla konfigurierte Datenbanknutzer muss über uneingeschränkten Zugriff auf die Joomla-Datenbank verfügen.

Öffnen Sie in Ihrem Hosting-Control-Panel den Bereich "Datenbankverwaltung" und überprüfen Sie Folgendes:

Der Nutzer wird der richtigen Datenbank zugeordnet
Der Nutzer verfügt über Lese- und Schreibrechte für Daten

Joomla benötigt Berechtigungen für Vorgänge wie beispielsweise:

SELECT
INSERT
UPDATE
DELETE
CREATE
ALTER
INDEX

Ein Nutzer mit eingeschränkten Berechtigungen kann zwar bestimmte Vorgänge ausführen, es kommt jedoch zu Fehlern, wenn Joomla versucht, Inhalte zu aktualisieren, Erweiterungen zu installieren oder Konfigurationsänderungen zu speichern.

5. Verfügbarkeit des MySQL- oder MariaDB-Servers überprüfen

Wenn Sie Ihren eigenen VPS oder dedizierten Server verwalten, überprüfen Sie, ob der Datenbankdienst läuft.

Für MySQL:

systemctl status mysql

Für MariaDB:

systemctl status mariadb

Wenn der Dienst angehalten wurde, starten Sie ihn neu:

systemctl restart mysql

oder:

systemctl restart mariadb

Überprüfen Sie außerdem die Protokolle des Datenbankservers:

/var/log/mysql/error.log

oder:

/var/log/mariadb/mariadb.log

Ein überlasteter, abgestürzter oder ein Datenbankserver, dem der Speicherplatz ausgegangen ist, kann zu Verbindungsfehlern bei Joomla führen.

6. PHP-Anforderungen für Joomla 6 überprüfen

Joomla 6 erfordert eine unterstützte PHP-Umgebung.

Falls Ihr Hosting-Anbieter kürzlich die PHP-Version geändert hat, überprüfen Sie bitte, ob die aktive PHP-Version mit Joomla 6 kompatibel ist.

Überprüfen Sie die PHP-Version in Ihrem Hosting-Control-Panel.

Die wichtigsten datenbankbezogenen Erweiterungen sind:

mysqli
PDO
pdo_mysql

Ohne einen funktionierenden MySQL-PHP-Treiber kann Joomla nicht mit der Datenbank kommunizieren.

Bei Shared Hosting sollten Sie Ihren Hosting-Anbieter bitten, zu bestätigen, dass diese Erweiterungen aktiviert sind.

7. Joomla-Cache manuell leeren

Ein Datenbankverbindungsfehler verhindert in der Regel den Zugriff auf den Joomla-Administrationsbereich, sodass der Cache (zwischenspeicher) nicht über das Control Panel geleert werden kann.

Sie können zwischengespeicherte Dateien manuell über FTP oder den Dateimanager Ihres Hosting-Anbieters löschen.

Öffnen Sie:

/cache/

Löschen Sie den Inhalt des Verzeichnis.

Löschen Sie nicht:

/cache/index.html

Falls Ihre Installation das Administrator-Cache-Verzeichnis enthält, löschen Sie außerdem:

/administrator/cache/

Löschen Sie nicht:

/administrator/cache/index.html

Das Leeren des Caches behebt in der Regel kein echtes Problem mit der Datenbankverbindung, entfernt jedoch nach Konfigurationsänderungen alte zwischengespeicherte Daten und stellt einen sicheren Schritt zur Fehlerbehebung dar.

8. Joomla-Fehlerbehebung aktivieren

Sollte das Problem weiterhin unklar sein, aktivieren Sie die Fehlermeldung von Joomla.

Öffnen Sie:

/configuration.php

Finden Sie:

public $debug = false;
public $error_reporting = 'default';

Ändern Sie es zu:

public $debug = true;
public $error_reporting = 'maximum';

Laden Sie die Website neu.

Joomla zeigt nun möglicherweise eine ausführlichere Fehlermeldung an.

Zu den häufigsten Datenbankfehlern gehören:

Zugriff für Nutzer verweigert

Beispiel:

Access denied for user 'username'@'localhost'

Ursache:

Falsches Passwort
Falscher Nutzername
Fehlende Berechtigungen

Lösung:

Datenbanknutzer überprüfen
Passwort zurücksetzen
configuration.php aktualisieren

Unbekannte Datenbank

Beispiel:

Unknown database 'database_name'

Ursache:

Falscher Datenbankname
Gelöschte Datenbank

Lösung:

Überprüfen Sie:

public $db = 'database_name';

und überprüfen Sie, ob die Datenbank in Ihrem Hosting-Panel vorhanden ist.

Verbindung abgelehnt

Beispiel:

Connection refused

Ursache:

Der MySQL/MariaDB-Dienst ist ausgefallen
Falscher Datenbank-Hostname
Firewall-Einschränkungen

Lösung:

Überprüfen Sie den Status des Datenbankservers oder wenden Sie sich an Ihren Hosting-Anbieter.

9. Server-Fehlerprotokolle überprüfen

Falls Joomla nicht genügend Informationen anzeigt, überprüfen Sie die Serverprotokolle.

Meistens sind diese hier zu finden:

Apache:

/var/log/apache2/error.log

Nginx:

/var/log/nginx/error.log

PHP-Fehler werden möglicherweise auch in Ihrem Hosting-Control-Panel unter folgendem Menüpunkt angezeigt:

Error Logs
PHP Logs
Server Logs

Suche nach Einträgen zu folgenden Themen:

MySQL
mysqli
PDO
Zeitüberschreitung bei der Verbindung (connection timeout)
Zugriff verweigert (permission denied)

10. Dateiberechtigungen prüfen

Falsche Dateiberechtigungen führen in der Regel nicht direkt zu Datenbankverbindungsfehlern, können jedoch nach Migrationen, Wiederherstellungen oder Serveränderungen auftreten.

Die empfohlenen Joomla-Berechtigungen sind in der Regel wie folgt:

Verzeichnisse:

Dateien:

Die Joomla-Konfigurationsdatei sollte nicht für jeden beschreibbar sein.

Überprüfen Sie:

/configuration.php

und stellen Sie sicher, dass es über die entsprechenden Berechtigungen verfügt.

11. Wenn das Problem durch den Hosting-Anbieter verursacht wird

Wenn alle Joomla-Einstellungen korrekt sind und die Datenbank dennoch nicht erreichbar ist, liegt das Problem wahrscheinlich außerhalb von Joomla.

Mögliche Ursachen sind können unter anderem sein:

Ausfall des MySQL-Servers
Überlastung des Datenbankservers
Blockierte Datenbankverbindungen
Beschädigte Datenbanktabellen
Überschrittene Hosting-Limits
Firewall-Einschränkungen

Geben Sie bei der Kontaktaufnahme mit Ihrem Hosting-Anbieter Folgendes an:

Joomla Version
PHP Version
Datenbanktyp (MySQL oder MariaDB)
genaue Fehlermeldung
Zeitpunkt, an dem das Problem auftrat

Damit kann das Hosting-Support-Team das Problem schneller identifizieren.

Checkliste zur Fehlerbehebung bei der Datenbankverbindung in Joomla 6

Bevor Sie sich an den Support wenden, überprüfen Sie bitte Folgendes:

☐ /configuration.php enthält korrekte Datenbank-Anmeldedaten
☐ Der Hostname der Datenbank ist korrekt
☐ Die Datenbank existiert
☐ Der Datenbanknutzer verfügt über alle Berechtigungen
☐ phpMyAdmin kann auf die Datenbank zugreifen
☐ PHP-MySQL-Erweiterungen sind aktiviert
☐ Der MySQL/MariaDB-Dienst läuft
☐ Die Joomla-Cache-Verzeichnisse wurden geleert
☐ Der Debug-Modus wurde aktiviert und die Fehlermeldung überprüft
☐ Die Serverprotokolle wurden überprüft

Fazit

Der Fehler "Verbindung zur Datenbank konnte nicht hergestellt werden" in Joomla 6 wird in der Regel durch falsche Datenbankeinstellungen oder ein Problem mit dem Datenbankserver verursacht.

Beginnen Sie mit den einfachsten Überprüfungen: