Zum Hauptinhalt springen

Häufige Probleme & Lösungen

Ein umfassender Leitfaden zu den häufigsten Problemen und ihren Lösungen.

Installationsprobleme​

Leere weiße Seite nach der Installation​

Ursache: Meist ein Berechtigungsproblem.

Lösung:

# Laravel-Log prüfen
tail -50 storage/logs/laravel.log

# Berechtigungen korrigieren
sudo chmod -R 775 storage bootstrap/cache
sudo chown -R www-data:www-data storage bootstrap/cache

„Class Not Found"-Fehler​

Ursache: Composer-Abhängigkeiten nicht installiert oder Autoloader nicht generiert.

Lösung:

composer install --no-dev --optimize-autoloader
php artisan config:clear

Installer zeigt „Bereits installiert"​

Ursache: Die Datei storage/installed.lock existiert.

Lösung: Falls Sie den Installer erneut ausführen müssen:

rm storage/installed.lock

Dann /install erneut aufrufen.

CSS/JS lädt nicht (ungestylte Seite)​

Ursache: Storage-Symlink fehlt oder Asset-Pfadproblem.

Lösung:

php artisan storage:link
php artisan config:clear
php artisan view:clear

Prüfen Sie außerdem, ob APP_URL in .env mit Ihrer tatsächlichen Domain übereinstimmt (einschließlich https://).

Datenbankprobleme​

„SQLSTATE[HY000] [2002] Connection Refused"​

Ursache: MySQL läuft nicht oder falscher Host.

Lösung:

  • Prüfen ob MySQL läuft: sudo systemctl status mysql
  • In .env 127.0.0.1 statt localhost versuchen
  • Port prüfen (Standard: 3306)

„SQLSTATE[HY000] [1045] Access Denied"​

Ursache: Falsche Datenbankzugangsdaten.

Lösung:

  • Benutzername/Passwort in .env prüfen
  • Verbindung testen: mysql -u your_user -p your_database
  • Berechtigungen neu vergeben:
GRANT ALL PRIVILEGES ON feedbackpulse.* TO 'your_user'@'localhost';
FLUSH PRIVILEGES;

Emojis werden als ???? angezeigt​

Ursache: Datenbank-Zeichensatz ist utf8 statt utf8mb4.

Lösung:

ALTER DATABASE feedbackpulse CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Webserver-Probleme​

Alle Routen geben 404 zurück​

Apache-Lösung:

sudo a2enmod rewrite
sudo systemctl restart apache2

Sicherstellen, dass AllowOverride All in Ihrem Virtual Host gesetzt ist.

Nginx-Lösung: Sicherstellen, dass Ihr Server-Block enthält:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

502 Bad Gateway (Nginx)​

Ursache: PHP-FPM läuft nicht oder falscher Socket-Pfad.

Lösung:

sudo systemctl restart php8.4-fpm
# Socket-Pfad prüfen
ls /var/run/php/php8.4-fpm.sock

413 Request Entity Too Large​

Ursache: Upload-Größenlimit zu niedrig.

Lösung (Nginx):

client_max_body_size 20M;

Lösung (PHP):

upload_max_filesize = 20M
post_max_size = 25M

Authentifizierungsprobleme​

„CSRF Token Mismatch" (419-Fehler)​

Ursache: Session abgelaufen oder Cookie-Problem.

Lösung:

  • Browser-Cookies löschen und erneut versuchen
  • SESSION_DOMAIN in .env prüfen (auf .yourdomain.com für Subdomains setzen)
  • SESSION_SECURE_COOKIE=true nur setzen, wenn HTTPS verwendet wird

Kann mich nach Passwort-Reset nicht anmelden​

Ursache: Browser hat die alte Session gecacht.

Lösung: Browser-Cookies löschen oder Inkognito-Modus verwenden.

Social Login gibt Fehler zurück​

Ursache: Callback-URL stimmt nicht überein.

Lösung: Sicherstellen, dass die Callback-URL in der Google/GitHub-Konsole genau übereinstimmt:

  • Google: https://yourdomain.com/auth/google/callback
  • GitHub: https://yourdomain.com/auth/github/callback

Zahlungsprobleme​

Detaillierte Zahlungsfehlerbehebung finden Sie unter Zahlungs-Gateway-Probleme.

E-Mail-Probleme​

Detaillierte E-Mail-Fehlerbehebung finden Sie unter E-Mails werden nicht gesendet.

Performance-Probleme​

Optimierungstipps finden Sie unter Performance-Optimierung.

Cache-Probleme​

Im Zweifel alle Caches leeren:

php artisan optimize:clear

Dies löscht:

  • Konfigurations-Cache
  • Routen-Cache
  • View-Cache
  • Anwendungs-Cache
  • Kompilierten Klassen-Cache

Debug-Modus (vorübergehend)​

Um detaillierte Fehlermeldungen anzuzeigen:

  1. .env bearbeiten:
APP_DEBUG=true
LOG_LEVEL=debug
  1. Den Fehler reproduzieren
  2. Die Fehlerseite oder storage/logs/laravel.log prüfen
  3. APP_DEBUG=false sofort danach setzen!
warnung

APP_DEBUG=true niemals in der Produktion lassen. Es gibt sensible Informationen preis.

Hilfe erhalten​

Falls keine der obigen Lösungen Ihr Problem behebt:

  1. storage/logs/laravel.log nach dem vollständigen Fehler-Trace prüfen
  2. Ihren Webserver-Fehlerlog prüfen (/var/log/nginx/error.log oder /var/log/apache2/error.log)
  3. Die CodeCanyon-Kommentare nach ähnlichen Problemen durchsuchen
  4. Ein Support-Ticket öffnen mit:
    • Fehlermeldung (aus dem Log)
    • PHP-Version (php -v)
    • Laravel-Version
    • Server-Details (Betriebssystem, Webserver, MySQL-Version)
    • Reproduktionsschritte