Fehler-Lösung
SQLSTATE[HY000] [2002] Connection refused beheben
Laravel erreicht den Datenbankserver unter der konfigurierten Adresse nicht.
Die Fehlermeldung
SQLSTATE[HY000] [2002] Connection refusedMögliche Ursachen
- Datenbankserver läuft nicht. MySQL oder MariaDB ist nicht gestartet oder lauscht auf einem anderen Port.
- Falscher DB_HOST oder DB_PORT. In Docker erreicht der App-Container die Datenbank unter dem Service-Namen, nicht unter 127.0.0.1.
- Zwischengespeicherte Konfiguration. Nach php artisan config:cache wird die .env-Datei nicht mehr gelesen. Änderungen an DB_HOST wirken erst nach einem neuen Cache.
Lösung
- Prüfen, ob der Datenbankdienst läuft und auf welchem Port er lauscht.
- DB_HOST und DB_PORT in der .env anpassen (bei Docker: Name des Datenbank-Services).
- Danach php artisan config:clear ausführen, bei Produktion anschließend neu cachen.
Quelle: Laravel 12.x: Configuration (Environment) und Deployment · Stand: 2026-10-09
Verwandte Fehler
Fehler bleibt bestehen?
Ich schaue mir Ihr Laravel-Projekt an und sage Ihnen ehrlich, woran es liegt. Kostenloses 30-Minuten-Gespräch.