Fehler sicher eingrenzen und beheben
Ordne sichtbare Symptome Sitzung, Rolle, Paketumfang, Datenzustand, externem Dienst oder Gerät zu und vermeide riskante Wiederholungen.
- Rollen
- owner, manager, staff, customer
- Benötigte Module
- Kein Zusatzmodul erforderlich
- Zuletzt fachlich geprüft
Worum es geht
Gute Fehlerbehebung beginnt mit dem tatsächlichen Nutzerzustand. Sie unterscheidet Anzeige, gespeicherte Daten, Ergebnis der Schnittstelle, Zustand externer Dienste und andere Abhängigkeiten, bevor eine Aktion wiederholt oder Daten verändert werden.
Voraussetzungen
- Notiere Route, Zeitpunkt, Rolle, Betrieb und sichtbare Fehlermeldung.
- Verwende maskierte IDs statt persönlicher Daten oder Secrets.
- Aktualisiere den Serverzustand, bevor du eine möglicherweise bereits ausgeführte Aktion wiederholst.
Schritt für Schritt
Symptom exakt festhalten
Kopiere die sichtbare Meldung, notiere den erwarteten Schritt und beschreibe, was unmittelbar davor geklickt oder eingegeben wurde.
Erwartetes Ergebnis: Das Problem ist reproduzierbar beschrieben und nicht nur als funktioniert nicht gemeldet.Kontext prüfen
Kontrolliere Betrieb, Rolle, Paketumfang, Sprache, Gerät, Netzstatus und Route. Prüfe, ob der Zustand Laden, Leer, Nicht verfügbar, Verboten oder Konflikt ist.
Erwartetes Ergebnis: Die wahrscheinlichste Fehlerklasse ist eingegrenzt.Sicheren Wiederholungsweg wählen
Lade die betroffene Ressource neu. Wiederhole nur idempotente Lesevorgänge sofort; prüfe bei Buchung, Zahlung, Versand, Refund oder Check-in zuerst das Aktivitätsprotokoll.
Erwartetes Ergebnis: Es entsteht kein doppelter Vorgang durch eine unklare Wiederholung.Supportbeleg vorbereiten
Erstelle einen Screenshot ohne personenbezogene Daten, nenne maskierte Referenz, UTC/Ortszeit, Browser, Viewport und exakten Wiederholungsweg.
Erwartetes Ergebnis: Support kann den Fall über Betrieb und Zeitpunkt finden, ohne ein Geheimnis zu erhalten.
So sieht es aus
Häufige Fehlerklassen
401 weist auf fehlende oder abgelaufene Anmeldung hin. 403 bedeutet fehlende Rolle oder Capability. ENTITLEMENT_REQUIRED nennt ein fehlendes Modul. CONFLICT beschreibt einen fachlichen Zustand. EXTERNAL_SERVICE_NOT_CONFIGURED meldet einen sicher abgefangenen Fehler eines externen Dienstes.
422 weist häufig auf ungültige Eingabe, Token oder nicht mehr passenden Workflowzustand hin. Lies immer die bereinigte Nutzerbotschaft und die sichtbaren Felder.
Doppelte Aktionen vermeiden
Zahlung, Ticketkauf, Statuskommando, Mailversand, Erstattung, Check-in und Coupon-Einlösung können bereits serverseitig abgeschlossen sein, obwohl der Browser die Antwort verloren hat.
Aktualisiere zuerst Ressource und Verlauf. Ein zweiter Versuch ist erst sicher, wenn der erste eindeutig nicht angelegt wurde oder der Workflow eine idempotente Wiederholung vorsieht.
Sichere Supportinformationen
Hilfreich sind Route, Zeit, Rolle, Name des Betriebs, maskierte ID, sichtbarer Status, Browser und reproduzierbare Schritte. Nicht hilfreich und verboten sind Passwort, Token, QR-Payload, API-Key, Recovery-Code oder vollständiger Gästeexport.
Wenn etwas nicht funktioniert
Anmeldung funktioniert nicht.
- Wahrscheinliche Ursache
- Passwort falsch, Anmeldelink verbraucht, Konflikt mit externem Konto, MFA-Zeit oder Sitzung abgelaufen.
- Sichere Lösung
- Nutze genau eine aktuelle Methode, fordere einen neuen Magic Link an oder prüfe MFA-Zeit. Teile keine Codes mit Support.
Zahlung oder Mailprovider ist nicht konfiguriert.
- Wahrscheinliche Ursache
- Externe Konfiguration oder Capability fehlt.
- Sichere Lösung
- Behandle den Workflow als blockiert, nicht als erfolgreich. Inhaber/in oder Admin prüft den Status des externen Dienstes; der Nutzer wiederholt erst nach Freigabe.
Fehlende Berechtigung trotz sichtbarer Schaltfläche.
- Wahrscheinliche Ursache
- Rolle änderte sich, Sitzung ist veraltet oder UI- und Serverkontext weichen ab.
- Sichere Lösung
- Lade Sitzung und Seite neu, prüfe Teamrolle und melde Route sowie Aktion. Umgehe die API-Prüfung nicht.
Beschriebene Produktoberflächen
/hilfe/probleme-loesen