Betrieb
Störungssuche
| Beobachtung | Wahrscheinliche Ursache | Vorgehen |
|---|---|---|
| Downloads sind 0 Byte groß | Beschleunigte Auslieferung falsch eingerichtet | Einstellungen → Auslieferung → Selbsttest; im Zweifel auf „PHP-Streaming" stellen. Siehe Auslieferung |
| Großer Upload bricht ab | PHP- oder Webserver-Grenze zu klein | Werte aus den Systemanforderungen prüfen; Warnung in Systemdaten beachten |
| Upload bleibt bei 100 % stehen | Kein Queue-Worker, Prüfsumme oder Verschlüsselung hängt | Läuft queue:work? php artisan queue:failed. Siehe Cron einrichten |
| „wird geändert …" verschwindet nicht | Verschlüsselungs-Job abgestürzt | queue:failed, Job erneut anstoßen. Der Marker gilt nach 2 Stunden als verwaist und blockiert nicht dauerhaft |
| Keine Mails | Zugang falsch oder Provider blockiert | Einstellungen → E-Mail → Test-Mail; die Fehlermeldung steht im Klartext da |
| Mails landen im Spam | SPF/DKIM fehlen, Absender passt nicht zur Domain | DNS-Einträge setzen, Absenderadresse anpassen |
| Logo erscheint nicht | storage:link fehlt |
php artisan storage:link |
| Oberfläche ohne Gestaltung | public/build/ fehlt |
Assets bauen und hochladen, oder das Release-Paket nehmen |
Änderung an .env wirkt nicht |
Konfiguration zwischengespeichert | php artisan config:clear |
| Zugangsdaten stimmen, werden aber abgewiesen | Ein # im Passwort in der .env |
Wert in doppelte Anführungszeichen setzen — sonst schneidet der Parser ihn dort ab |
| Neue Seite zeigt 404 | Adresse ist reserviert oder Seite nicht veröffentlicht | Anderen Slug wählen; Häkchen „veröffentlicht" prüfen |
/install antwortet mit 404 |
Es existiert bereits ein Administrator | Nichts zu tun — der Installer schließt sich selbst |
| „Kopieren" funktioniert nicht | Kein HTTPS (kein sicherer Kontext) | TLS einrichten; der Text lässt sich derweil markieren |
500er, failed to open stream: Permission denied |
Ein Verzeichnis unter storage/ fehlt oder ist nicht beschreibbar |
php artisan fileshare:check nennt es |
.env ist für alle lesbar |
Auf einem geteilten Server liest jeder Nachbar Datenbank-Passwort und Schlüssel mit | chmod 640 .env |
composer install bricht mit Datenbankfehler ab |
Fassung älter als 1.1 | Aktualisieren |
| Uhrzeiten liegen ein bis zwei Stunden daneben | APP_TIMEZONE weicht von der Zone der Nutzer ab |
Passende Zone setzen — nur vor dem ersten Produktivdatensatz, siehe Konfiguration |
| Niemand kommt mehr in ein Konto (2FA verloren) | Gerät und Codes weg | Nutzer → Zwei-Faktor zurücksetzen, nach Rückfrage auf anderem Weg. Siehe Konten |
Für Support-Anfragen: Einstellungen → Systemdaten → Bericht kopieren. Er enthält alle Betriebswerte und keine Geheimnisse.
Quelle dieser Seite:
docs/betrieb/stoerungssuche.md
im Repository. Sie wird beim Bauen daraus erzeugt — Änderungen gehören in die
Markdown-Datei, nicht in diese Seite.