Troubleshooting
Verwenden Sie diese Seite, um häufige CLI-Meldungen Behebungen zuzuordnen.
Konfigurationsfehler
| Meldung | Ursache | Behebung |
|---|---|---|
Path is required. | Der Befehl hat keinen Datei- oder Ordnerpfad erhalten. | optimus check <path> übergeben. |
Path not found: ... | Der Pfad existiert nicht. | Pfad und Working Directory prüfen. |
--env must be 'test' or 'prod'. | Der Umgebungswert ist ungültig. | --env test oder --env prod verwenden. |
--verbose and --quiet cannot be used together. | Konfliktierende Konsolenausgabeoptionen. | Eine Option auswählen. |
Check type is required... | Kein Prüftyp wurde aufgelöst. | --standard, --qualified oder defaults.checkType verwenden. |
Column 'vatId' must be mapped... | Keine USt-IdNr.-Spalte wurde gemappt. | --col-vat-id oder columns.vatId hinzufügen. |
--base-url must be an absolute URL. | Die URL ist nicht absolut. | Vollständige URL wie https://example.test/ verwenden. |
CSV- Und Mapping-Fehler
| Meldung | Ursache | Behebung |
|---|---|---|
Could not load YAML file... | YAML fehlt, ist nicht lesbar oder ungültig. | Dateipfad und YAML-Syntax prüfen. |
Mapped column '...' was not found in the CSV header. | Mapping referenziert einen Header, der nicht existiert. | Headernamen oder Mapping-Datei korrigieren. |
must be a 1-based column index when --no-header is used. | No-Header Mode verwendet einen Namen oder ungültigen Index. | 1, 2, 3 usw. verwenden. |
Unknown input encoding... | Nicht unterstütztes Encoding. | utf-8, windows-1252 oder iso-8859-1 verwenden. |
Unknown output encoding... | Nicht unterstütztes Ausgabe-Encoding. | utf-8, windows-1252 oder iso-8859-1 verwenden. |
Unknown output column... | output.columns oder --out-columns enthält einen unbekannten Namen. | Reservierte Ausgabespalte, Shortcut oder konfigurierte Custom Column verwenden. |
Invalid regex in skipPattern... | Filter-Regex ist ungültig. | filter.skipPattern korrigieren. |
Authentifizierungs- Und API-Fehler
| Meldung | Ursache | Behebung |
|---|---|---|
No token configured... | API-Lauf ohne Token. | OPTIMUS_TOKEN setzen oder --token verwenden. |
Token is invalid or expired. | API hat das Token abgelehnt. | Neues Token erstellen oder anfordern. |
Quota exhausted. Please check your license. | API gab HTTP 402 zurück. | Lizenz oder Quote prüfen. |
Rate limit reached. Please wait and try again. | API gab HTTP 429 zurück. | Später erneut versuchen. |
Connection timeout... | API hat nicht rechtzeitig geantwortet. | Später erneut versuchen oder Netzwerkverbindung prüfen. |
Server error (...) | API gab HTTP 500 oder höher zurück. | Später erneut versuchen. Wenn es bestehen bleibt, Support kontaktieren. |
Resume-State-Probleme
| Meldung | Ursache | Behebung |
|---|---|---|
Saved validation state does not match... | Datei, Optionen, Request Hash oder API-Ziel haben sich geändert. | --force-new verwenden, wenn Sie eine neue Operation wollen. |
Saved validation state is unreadable... | State-Datei ist beschädigt. | --force-new in einem interaktiven Lauf verwenden oder State-Datei entfernen, wenn angemessen. |
Saved validation operation is no longer available... | API gab 404 für gespeicherten Operation-Lookup zurück. | Die CLI startet automatisch eine neue Operation. |
Folder-Mode-Probleme
| Symptom | Ursache | Behebung |
|---|---|---|
| Keine Dateien werden verarbeitet. | Keine Dateien passen zu pattern, Dateien sind in Unterordnern, enden mit _result oder sind jünger als minAge. | Ordnerstamm, Dateinamen, pattern und minAge prüfen. |
Datei wurde nach error verschoben. | Die Datei traf auf CLI-, Mapping-, Authentifizierungs-, IO-, temporären oder Quota-Fehler. | .err-Datei und Support-Log öffnen, Ursache beheben, dann Folder Mode mit --retry ausführen. |
Datei bleibt mit Duplicate-Destination-Meldung in processing. | onDuplicate ist skip und eine Datei gleichen Namens existiert bereits in done oder error. | Vorhandene Zieldatei prüfen. Danach Processing-Datei manuell verschieben/löschen oder mit --on-duplicate overwrite oder --on-duplicate rename erneut ausführen. |
Datei bleibt in processing. | Der Lauf wurde unterbrochen, während die Datei verarbeitet wurde. | Sicherstellen, dass kein CLI-Prozess mehr läuft, dann CSV und ihre .optimus-state.json-Sidecar-Datei zurück in den Ordnerstamm verschieben und Folder Mode erneut ausführen. |
Support Logs
Beim Troubleshooting mit detaillierter Ausgabe ausführen und Support-Log behalten:
optimus check customers.csv --map mapping.yml --standard --verbose --log-dir ./logs
Support-Logs sind so gestaltet, dass sie keine Tokens, CSV-Zeilenwerte, USt-IdNrn., Unternehmensnamen, Adressen oder Custom-Column-Werte enthalten.