Steckerfehler

Ein fehlerhafter Anschluss stoppt oft den gesamten Lauf. Diese Seite hilft Ihnen, den Fehler zu lesen, die Konfiguration zu korrigieren und doppelte Nebenwirkungen zu vermeiden.

1. Lesen Sie den ausgeführten und fehlerhaften Knoten

Öffnen Sie Ausführungen für den Workflow.
Wählen Sie die Ausführung Fehlgeschlagen aus.
Suchen Sie den roten Knoten: Fehlermeldung und maskierte Ausgabe (Geheimnisse werden nie angezeigt).

Technische Details werden gefiltert; Sie sehen immer noch die Fehlerklasse (HTTP 401, Dolibarr-Berechtigung, Zeitüberschreitung usw.).

2. Häufige Ursachen in der Familie

Dolibarr

Fehlende Berechtigung für das Objekt (Lesen, Erstellen, Löschen).
Ungültige „fk_soc“ oder ID für die aktuelle Entität.
Gesperrtes oder Entwurfsobjekt nicht validiert.

HTTP / Webhook

Falsche URL, falsches TLS-Zertifikat oder ausgehende Firewall.
Fehlerhafte Header oder Body (ungültiges JSON).
4xx/5xx-Antworten: Verwenden Sie Status und Text in der Laufausgabe.

E-Mail

SMTP nicht konfiguriert (oft in der freigegebenen Demo deaktiviert).
Abgelaufene SMTP-Anmeldeinformationen oder blockierter Port.

KI

Anmeldeinformationen/API-Schlüssel fehlen, sind abgelaufen oder widerrufen.
Anbieterkontingent überschritten oder Modell nicht verfügbar.

Logik

If-Zweig ohne Standardpfad.
Schleife oder Verzögerung falsch konfiguriert.

3. Wiederholung und Idempotenz

Knot kann vorübergehende Fehler wiederholen (Netzwerk, 503).
Aktivieren Sie für Erstellungsaktionen (Rechnung, Drittanbieter) Idempotenz, sofern unterstützt, damit bei Wiederholungsversuchen keine Daten dupliziert werden.

4. Eskalation

Situation	Action
Reproducible in Simulate	Fix node config before enabling in production.
Intermittent error	Check timeout, server load, third-party API limits.
Error after Knot upgrade	Read the CHANGELOG and retest a minimal workflow.

Siehe auch

Leistung und Grenzen – wenn Fehler wie Zeitüberschreitungen oder Sättigung aussehen.
Workflow wird nicht ausgeführt – wenn überhaupt keine Ausführung angezeigt wird.