Fehlerkatalog-Atlas: 30 Codes
Zentrale Fehler-Codes mit HTTP-Status, Retry-Strategie und Domain-Zuordnung. Aus planung_fehlerkatalog.
Domain: auth (7)
| Code | HTTP | Titel | Retry | Max | Backoff (s) | Beschreibung |
|---|---|---|---|---|---|---|
AUTH_FAILED |
401 | Authentifizierung fehlgeschlagen | kein_retry | 0 | 0 | Login-Credentials ungültig, Fail-Fast |
SESSION_EXPIRED |
401 | Session abgelaufen | kein_retry | 0 | 0 | Timeout, neu einloggen |
CSRF_TOKEN_INVALID |
403 | CSRF-Token ungültig | kein_retry | 0 | 0 | Formular-Token falsch oder expired |
MAGIC_CODE_INVALID |
403 | Magic-Code ungültig | kein_retry | 0 | 0 | Code existiert nicht oder bereits eingelöst |
MAGIC_CODE_ALREADY_USED |
409 | Magic-Code bereits verwendet | kein_retry | 0 | 0 | Replay-Angriff verhindert |
MAGIC_CODE_EXPIRED |
410 | Magic-Code abgelaufen | kein_retry | 0 | 0 | Code nach 15 Minuten verfallen, neuer Code anfordern |
RATE_LIMIT_EXCEEDED |
429 | Zu viele Anfragen | linear_backoff | 3 | 900 | 5 Requests pro 15 Min pro IP oder Email |
Domain: payment (4)
| Code | HTTP | Titel | Retry | Max | Backoff (s) | Beschreibung |
|---|---|---|---|---|---|---|
PAYPAL_AUTH_FAILED |
401 | PayPal-OAuth fehlgeschlagen | manuelle_intervention | 0 | 0 | Credentials prüfen, nicht auto-retryen |
PAYPAL_INSUFFICIENT_FUNDS |
402 | Unzureichende Deckung beim Zahler | kein_retry | 0 | 0 | User muss Zahlungsmethode korrigieren |
PAYPAL_INVALID_RESPONSE |
502 | PayPal-API ungültige Antwort | exponential_backoff | 3 | 30 | JSON-Parse oder Schema-Fehler |
PAYPAL_UNAVAILABLE |
502 | PayPal-API nicht erreichbar | exponential_backoff | 5 | 60 | HTTP 502/503/504, mit Backoff-Retry |
Domain: email (8)
| Code | HTTP | Titel | Retry | Max | Backoff (s) | Beschreibung |
|---|---|---|---|---|---|---|
EMAIL_BIDI_ATTACK |
400 | BIDI-Unicode-Angriff in Email | kein_retry | 0 | 0 | Rechts-nach-Links Override erkannt |
EMAIL_HEADER_INJECTION_ATTEMPT |
400 | Header-Injection in Email-Feld | kein_retry | 0 | 0 | CRLF-Zeichen erkannt, Angriffsversuch |
EMAIL_INVALID_FORMAT |
400 | Email-Format ungültig | kein_retry | 0 | 0 | filter_var FILTER_VALIDATE_EMAIL Failure |
EMAIL_TOO_LONG |
400 | Email laenger als 254 Zeichen | kein_retry | 0 | 0 | RFC 5321 Limit ueberschritten |
EMAIL_DISPOSABLE_BLOCKED |
403 | Wegwerf-Email-Adresse blockiert | kein_retry | 0 | 0 | Domain auf Disposable-Blocklist |
EMAIL_DOMAIN_NO_MX |
422 | Email-Domain hat keinen MX-Eintrag | kein_retry | 0 | 0 | Domain existiert, aber keine Mail-Zustellung moeglich |
MAIL_DELIVERY_FAILED |
502 | Mail-Zustellung fehlgeschlagen | exponential_backoff | 3 | 60 | SMTP-Fehler 5xx, mit Retry |
MAIL_BOUNCE_HARD |
550 | Mail-Bounce hart | kein_retry | 0 | 0 | Empfaenger existiert nicht, nicht wiederholen |
Domain: dsgvo (3)
| Code | HTTP | Titel | Retry | Max | Backoff (s) | Beschreibung |
|---|---|---|---|---|---|---|
DSGVO_REQUEST_INVALID |
400 | DSGVO-Antrag ungültig | kein_retry | 0 | 0 | Antrag ohne Identitaetsnachweis |
DSGVO_DELETION_BLOCKED |
409 | DSGVO-Löschung blockiert | manuelle_intervention | 0 | 0 | Laufender Vertrag blockiert Löschung |
DSGVO_EXPORT_TIMEOUT |
504 | DSGVO-Export-Timeout | exponential_backoff | 3 | 300 | Datenmenge zu gross, async Job |
Domain: api (3)
| Code | HTTP | Titel | Retry | Max | Backoff (s) | Beschreibung |
|---|---|---|---|---|---|---|
LEXOFFICE_UNAUTHORIZED |
401 | lexoffice API-Key ungültig | manuelle_intervention | 0 | 0 | Key rotiert, manuell erneuern |
LEXOFFICE_VALIDATION_ERROR |
422 | lexoffice Validierungs-Fehler | kein_retry | 0 | 0 | Payload-Schema-Fehler, nicht retryen |
LEXOFFICE_RATE_LIMIT |
429 | lexoffice Rate-Limit erreicht | exponential_backoff | 5 | 120 | 2 Req/sec, Throttle |
Domain: storage (1)
| Code | HTTP | Titel | Retry | Max | Backoff (s) | Beschreibung |
|---|---|---|---|---|---|---|
STORAGE_QUOTA_EXCEEDED |
507 | Speicher-Quota erreicht | manuelle_intervention | 0 | 0 | Admin-Eingriff noetig |
Domain: db (3)
| Code | HTTP | Titel | Retry | Max | Backoff (s) | Beschreibung |
|---|---|---|---|---|---|---|
DB_DEADLOCK |
409 | DB-Deadlock | sofort_aufgeben | 3 | 1 | Sofort-Retry, danach Fail-Fast |
DB_UNIQUE_CONSTRAINT |
409 | Eindeutigkeitsverletzung | kein_retry | 0 | 0 | Business-Logik-Konflikt |
DB_CONNECTION_LOST |
503 | DB-Verbindung verloren | exponential_backoff | 5 | 5 | Transient DB-Fehler, mit Backoff |
Domain: system (1)
| Code | HTTP | Titel | Retry | Max | Backoff (s) | Beschreibung |
|---|---|---|---|---|---|---|
INTERNAL_ERROR |
500 | Interner Fehler | sofort_aufgeben | 0 | 0 | Nicht-klassifizierter Fehler, logs prüfen |