9. Fehlersuche

Bei Störungen lohnt es sich, zuerst den betroffenen Bereich einzugrenzen: Anwendung, Datenbank, Mail, Queue, Browser-Laufzeit oder Webserver.

9.1. Häufige Fehlerbilder

9.1.1. Login funktioniert nicht

Prüfen Sie:

• stimmt APP_URL?
• stimmen Session- und Cookie-Einstellungen?
• funktioniert die Datenbank?
• ist das Benutzerkonto aktiv?

9.1.2. Seiten laden, aber Speichern schlägt fehl

Prüfen Sie:

• Anwendungslog
• Datenbankverbindung
• PHP-Fehler
• fehlende Schreibrechte

9.1.3. Debug- oder Entwicklerseiten sind erreichbar

Prüfen Sie:

• APP_DEBUG steht nicht versehentlich auf true
• BOOST_ENABLED und BOOST_BROWSER_LOGS_WATCHER sind nicht unbeabsichtigt aktiviert
• IGNITION_ENABLE_RUNNABLE_SOLUTIONS ist nicht aktiviert
• TELESCOPE_ENABLED ist nur für bewusst abgesicherte lokale Sitzungen aktiv
• DUSK_ENABLED ist nur für gezielte Browser-Tests aktiv
• Entwicklungswerkzeuge wie Dusk oder Telescope laufen nicht auf einem öffentlich erreichbaren System

9.1.4. Mails kommen nicht an

Prüfen Sie:

• Mail-Konfiguration in .env
• SMTP-Verbindung
• SPF, DKIM, DMARC
• Queue-Worker, falls Mailversand asynchron läuft

9.1.5. PDF- oder Browser-Ausgaben schlagen fehl

Prüfen Sie:

• Chromium/Chrome installiert?
• Systembibliotheken vollständig?
• Startet der Browser für den Webserver-Benutzer?
• gibt es genug temporären Speicher?

9.1.6. Updates brechen ab

Prüfen Sie:

• lokaler Git-Status
• Upstream-Branch
• Composer- oder npm-Abhängigkeiten
• Migrationen
• Dateirechte

9.2. Wichtige Protokollquellen

• Laravel-Logs in storage/logs/
• Webserver-Logs
• PHP-FPM- oder Prozess-Logs
• Queue- und Scheduler-Logs
• Container-Logs bei Docker

9.3. Gute Reihenfolge bei der Fehlersuche

1. Symptom kurz beschreiben.
2. Reproduzierbarkeit prüfen.
3. Logs derselben Zeitspanne ansehen.
4. zuletzt geänderte Systemteile notieren.
5. erst dann korrigieren oder zurückrollen.