Skip to content

Automation läuft doppelt: Ursachen systematisch finden

Eine Automation verschickt dieselbe E-Mail zweimal oder legt einen Vorgang doppelt an. Dieser Artikel zeigt dir, wie du einen konkreten Fall vom fachlichen Ereignis bis zur externen Aktion verfolgst und die Ursache statt nur das Symptom behebst.

Moritz Klaßen

Moritz Klaßen

Entwickler & Gründer von Klassen AI

8 Min. Lesezeit

Wenn eine Automation dieselbe Aktion zweimal ausführt, wird meist ein doppelt angelegter Zeitplan oder Cronjob verdächtigt. Das greift zu kurz. Ein einzelner fachlicher Vorgang kann an mehreren Übergängen vervielfacht werden: beim Auslöser, während der Verarbeitung, durch einen Wiederholungsversuch oder erst beim Zugriff auf ein externes System.

Darum beginnt eine brauchbare Fehleranalyse nicht mit neuen Filtern oder längeren Wartezeiten. Du musst einen betroffenen Vorgang lückenlos verfolgen und feststellen, an welcher Stelle aus einer beabsichtigten Aktion zwei Ausführungen wurden.

Definiere zuerst, was „doppelt“ bedeutet

Nimm als Beispiel eine Kontaktanfrage. Nach dem Absenden soll die Automation einen CRM-Vorgang anlegen und eine Eingangsbestätigung verschicken. Später meldet jemand, die Bestätigung sei zweimal angekommen.

Die zwei E-Mails allein beweisen noch nicht, dass die gesamte Automation doppelt gelaufen ist. Möglicherweise wurde das Formular zweimal abgeschickt. Vielleicht existiert nur ein Formulareingang, aber zwei Jobs wurden gestartet. Es kann auch ein Job mit zwei Sendeversuchen gewesen sein. Oder die zweite Nachricht stammt aus einer weiteren Automation im CRM.

Lege deshalb fest, welche fachliche Einheit genau einmal verarbeitet werden sollte. Bei einer Kontaktanfrage kann das die Anfrage-ID sein. Bei einer Bestellung eignet sich die Bestell-ID in Verbindung mit der Aktion, etwa Bestellbestätigung senden. Die Kombination aus fachlichem Datensatz und beabsichtigter Aktion ergibt einen stabilen Aktionsschlüssel.

Ein Zeitstempel oder die E-Mail-Adresse reicht dafür selten aus. Derselbe Kontakt darf später eine weitere Anfrage senden. Zwei fachlich gültige Ereignisse können nahezu identisch aussehen, während ein technischer Wiederholungsversuch exakt denselben Vorgang erneut verarbeitet.

Sichere einen konkreten Fehlerfall, bevor du etwas änderst

Wähle einen einzelnen betroffenen Vorgang aus und notiere die bekannten Fakten. Du brauchst keine vollständige Auswertung aller Ausführungen. Für den Anfang genügt ein Fall, bei dem Empfänger, Inhalt und Zeitpunkt zuverlässig bekannt sind.

  • Welche fachliche ID gehört zum Vorgang?
  • Wann wurde der Auslöser registriert?
  • Wie viele technische Ausführungen wurden gestartet?
  • Gab es mehrere Versuche innerhalb derselben Ausführung?
  • Wann wurde die externe Aktion angefordert?
  • Welche Rückmeldung und welche externe ID kamen zurück?
  • Existiert ein manueller oder zweiter automatischer Weg zur gleichen Aktion?

Ändere die Automation noch nicht. Sobald du Wiederholungen deaktivierst, Zeitpläne verschiebst oder zusätzliche Bedingungen einbaust, veränderst du die Spuren des Fehlers. Dann verschwindet das Problem womöglich vorübergehend, ohne dass du seine Ursache kennst.

Verfolge den Vorgang über eindeutige Kennungen

Für die Analyse musst du drei Arten von Kennungen auseinanderhalten. Die fachliche ID bezeichnet den eigentlichen Vorgang, zum Beispiel die Anfrage oder Bestellung. Die Ausführungs-ID gehört zu einem konkreten Lauf der Automation. Die Versuchsnummer unterscheidet Wiederholungen innerhalb dieses Laufs.

Zusätzlich ist eine externe Kennung hilfreich, etwa die Nachrichten-ID eines E-Mail-Dienstes oder die ID des angelegten CRM-Eintrags. Damit kannst du prüfen, ob dein System die Aktion mehrfach angefordert hat oder ob nur die Darstellung beziehungsweise Rückmeldung irritiert.

Ein knapper Diagnoseeintrag sollte mindestens folgende Angaben verbinden:

  • fachliche ID und Aktionsschlüssel,
  • ID der eingehenden Zustellung,
  • Ausführungs-ID und Versuchsnummer,
  • Zeitpunkt vor und nach der externen Aktion,
  • Ergebnisstatus und externe Objekt-ID.

Speichere dabei nur die Daten, die du für die Zuordnung brauchst. Vollständige Formulareingaben, E-Mail-Inhalte oder API-Antworten landen sonst schnell dauerhaft in Protokollen, obwohl eine ID und ein Status genügt hätten.

Das Muster in den Kennungen zeigt die Fehlerstelle

Mehrere Zustellungen gehören zum selben fachlichen Ereignis

Wenn dieselbe fachliche ID mit unterschiedlichen Zustellungs-IDs eintrifft, liegt die Vervielfachung vor der eigentlichen Verarbeitung. Typische Ursachen sind erneut zugestellte Webhooks, ein mehrfach abgesendetes Formular oder zwei Systeme, die dasselbe Ereignis melden.

Prüfe in diesem Fall zuerst, wie die fachliche ID erzeugt wird. Erhält jeder technische Aufruf eine neue ID, kannst du eine Wiederholung nicht zuverlässig erkennen. Eine Deduplizierung allein anhand identischer Nutzdaten ist riskant, weil zwei gültige Vorgänge denselben Inhalt haben können.

Eine Zustellung startet mehrere Ausführungen

Bei nur einer Zustellung, aber mehreren Ausführungs-IDs liegt der Fehler in der Übergabe an die Verarbeitung. Dazu kann es kommen, wenn derselbe Datensatz von mehreren Regeln gefunden wird, zwei Worker unabhängig einen noch offenen Vorgang übernehmen oder eine Planung erneut startet, bevor der vorherige Lauf sichtbar abgeschlossen ist.

Ein kurzfristiger Lock kann parallele Zugriffe begrenzen. Er verhindert jedoch keinen späteren zweiten Lauf, sobald die Sperre abgelaufen ist. Für die dauerhafte Absicherung brauchst du zusätzlich einen fachlichen Aktionsschlüssel, dessen erfolgreiche Verarbeitung nur einmal gespeichert werden kann.

Eine Ausführung enthält mehrere Versuche

Wenn Ausführungs-ID und fachliche ID gleich bleiben, aber die Versuchsnummer steigt, ist ein Wiederholungsmechanismus beteiligt. Das ist grundsätzlich sinnvoll: Temporäre Netzwerkfehler oder nicht erreichbare Dienste sollen einen Prozess nicht sofort endgültig abbrechen.

Problematisch wird die Situation, wenn die externe Aktion bereits erfolgreich war, die Bestätigung aber nicht bei deiner Automation ankam. Ein E-Mail-Dienst kann die Nachricht angenommen haben, während die Verbindung beim Zurücksenden der Antwort abbricht. Deine Automation sieht dann einen Fehler und versucht denselben Versand erneut.

Der Status ist in diesem Moment nicht einfach „fehlgeschlagen“, sondern unbekannt. Diese Unterscheidung ist wichtig. Ein unbekanntes Ergebnis blind zu wiederholen, kann eine doppelte Aktion erzeugen. Es als Erfolg zu verbuchen, kann dagegen eine tatsächlich ausgefallene Aktion verdecken.

Die gleiche Aktion hat mehrere Eigentümer

Manchmal sind alle einzelnen Abläufe korrekt, aber zwei Abläufe fühlen sich für dieselbe Aufgabe zuständig. Das Formular verschickt eine Bestätigung, und das CRM sendet beim neuen Kontakt eine weitere. Oder ein Mitarbeiter legt den Vorgang manuell an, während die verzögerte Automation noch wartet.

Ordne deshalb jeder externen Aktion einen verantwortlichen Prozess zu. Wenn manuelle und automatische Bearbeitung parallel möglich sind, müssen beide denselben Bearbeitungsstatus oder Aktionsschlüssel beachten. Eine interne Absprache ersetzt keine technische Absicherung.

Behebe die Ursache an der passenden Grenze

Die Schutzmaßnahme richtet sich danach, wo die Vervielfachung entsteht. Eine pauschale Verzögerung kann den zeitlichen Abstand vergrößern, beseitigt aber keine doppelte Zustellung und keinen Wiederholungsversuch.

  • Doppelte Zustellung: Speichere die stabile Ereignis-ID und akzeptiere sie nur einmal. Falls die Quelle keine solche ID liefert, erzeuge früh einen fachlichen Schlüssel aus verlässlichen Domänendaten.
  • Parallele Übernahme: Reserviere den Vorgang atomar. Das bedeutet, dass Prüfung und Markierung als ein unteilbarer Datenbankvorgang erfolgen. Zwei Prozesse dürfen nicht gleichzeitig beide feststellen, der Datensatz sei noch frei.
  • Wiederholung nach unklarer Antwort: Verwende eine Idempotenz-ID, sofern das externe System sie unterstützt. Derselbe Aktionsschlüssel darf dort auch bei mehreren Anfragen nur eine fachliche Aktion auslösen.
  • Mehrere Prozesswege: Führe die Entscheidung über einen gemeinsamen Status oder eine gemeinsame Versandfunktion zusammen. So gelten dieselben Regeln für manuelle und automatische Auslöser.

Idempotenz bedeutet hier: Wenn du dieselbe beabsichtigte Aktion mit demselben Schlüssel erneut anforderst, bleibt das fachliche Ergebnis gleich. Aus zwei identischen Aufrufen entstehen also nicht zwei CRM-Einträge oder zwei Bestätigungen.

Für Aktionen in deiner eigenen Datenbank ist eine eindeutige Datenbankbedingung oft die letzte verlässliche Sicherung. Beispielsweise darf die Kombination aus Anfrage-ID und Aktionstyp nur einmal vorkommen. Eine vorherige Abfrage wie „Existiert der Eintrag schon?“ genügt bei parallelen Prozessen nicht. Beide können gleichzeitig „nein“ lesen und anschließend jeweils einen Datensatz anlegen.

Bei externen Diensten hängt die Absicherung von deren Funktionen ab. Unterstützt der Dienst Idempotenzschlüssel, übergib deinen Aktionsschlüssel. Andernfalls solltest du prüfen, ob sich der Status über eine eigene Referenz oder externe ID abfragen lässt. Fehlen beide Möglichkeiten, bleibt nach einem Verbindungsabbruch eine Unsicherheit, die sich technisch nicht immer automatisch auflösen lässt.

Vermeide Reparaturen, die neue Fehler erzeugen

Einige schnelle Maßnahmen lassen doppelte Aktionen seltener erscheinen, verschieben das Risiko aber an eine andere Stelle.

  • Wiederholungen vollständig abschalten: Du vermeidest manche Duplikate, verlierst dafür Aktionen bei kurzen technischen Störungen.
  • Alle ähnlichen Nutzdaten blockieren: Du kannst zwei berechtigte Anfragen derselben Person fälschlich zusammenfassen.
  • Den Vorgang vor der externen Aktion als erledigt markieren: Stürzt der Prozess danach ab, wird die Aktion nie ausgeführt und ein weiterer Versuch unterdrückt.
  • Nur eine kurze Sperre setzen: Sie hilft gegen Gleichzeitigkeit, aber nicht gegen einen späteren Wiederholungsversuch.
  • Eine längere Wartezeit einbauen: Die zweite Aktion kommt später. Doppelt bleibt doppelt.

Bei Aktionen mit hohen Folgekosten kann eine Verzögerung trotzdem sinnvoll sein, weil sie ein Abbruchfenster schafft. Sie ist dann eine zusätzliche Sicherheitsstufe. Wie du eine solche Automation verzögert ausführst und Fehlaktionen abbrechen kannst, ist eine eigene Prozessentscheidung.

Teste gezielt den Fehlerfall, nicht nur den Normalfall

Nach der Korrektur reicht ein erfolgreicher Probelauf nicht aus. Du willst belegen, dass derselbe fachliche Vorgang auch unter ungünstigen Bedingungen nur die beabsichtigte Wirkung erzeugt.

  1. Sende dasselbe Ereignis mit derselben Ereignis-ID zweimal.
  2. Starte zwei Verarbeitungen desselben Vorgangs nahezu gleichzeitig.
  3. Erzwinge nach der externen Aktion einen Abbruch, bevor der Erfolg lokal gespeichert wird.
  4. Lasse den Wiederholungsmechanismus denselben Aktionsschlüssel erneut verarbeiten.
  5. Prüfe, ob ein manueller Eingriff und die Automation miteinander kollidieren können.

Während dieser Tests sollten E-Mails, Buchungen oder andere externe Aktionen nicht an reale Empfänger gehen. Du kannst die Entscheidung und die geplante Aktion zunächst protokollieren, ohne sie auszuführen. Dafür eignet sich ein Schattenmodus zum sicheren Testen von Automationen.

Prüfe anschließend nicht nur, ob ein Fehler angezeigt wurde. Entscheidend ist das fachliche Ergebnis: Existiert genau ein CRM-Eintrag? Wurde genau eine freigegebene Nachricht erzeugt? Ist nachvollziehbar, welcher zweite Versuch abgefangen wurde und warum?

Plane einen manuellen Weg für unklare Ergebnisse

Manche externen Aktionen lassen nach einem Verbindungsabbruch nicht sicher erkennen, ob sie erfolgreich waren. Wenn der Anbieter weder Idempotenz noch eine Abfrage über eine eigene Referenz unterstützt, kann deine Automation die Entscheidung zwischen Wiederholen und Stoppen nicht zuverlässig allein treffen.

Markiere solche Vorgänge als „Ergebnis unklar“ und lege sie einer Person zur Prüfung vor. Das ist kein technisches Versagen, sondern der korrekte Umgang mit fehlender Information. Ein geplanter manueller Fallback für Automationen verhindert, dass aus Unsicherheit automatisch eine zweite irreversible Aktion wird.

Eine doppelte Aktion ist eine Spur, keine Diagnose

Wenn eine Automation doppelt läuft, solltest du nicht zuerst an Zeitplänen, Filtern oder Verzögerungen drehen. Verfolge einen konkreten Vorgang anhand seiner fachlichen ID, Ausführungs-ID, Versuchsnummer und externen Referenz. Aus diesem Muster lässt sich erkennen, ob der Auslöser vervielfacht wurde, mehrere Verarbeitungen entstanden, ein Wiederholungsversuch beteiligt war oder zwei Prozesse dieselbe Aufgabe übernommen haben.

Die dauerhafte Korrektur sitzt genau an dieser Grenze. Stabile Aktionsschlüssel, atomare Reservierungen und Idempotenz verhindern, dass ein technischer Wiederholungsversuch zu einer zweiten fachlichen Wirkung wird. Wo ein externes System keine eindeutige Entscheidung erlaubt, brauchst du einen sichtbaren Status und einen manuellen Prüfweg. So wird aus „Die Automation macht das manchmal doppelt“ ein eingrenzbarer und überprüfbarer Fehlerfall.

Häufige Fragen

Kurz beantwortet, damit du schneller einschätzen kannst, was für dein Projekt wichtig ist.

Warum führt eine Automation dieselbe Aktion zweimal aus?

Mögliche Ursachen sind doppelt zugestellte Auslöser, mehrere parallele Verarbeitungen, automatische Wiederholungsversuche oder ein zweiter manueller beziehungsweise automatischer Prozess. Anhand von fachlicher ID, Ausführungs-ID und Versuchsnummer kannst du die Stelle eingrenzen.

Verhindert eine Sperre doppelte Ausführungen zuverlässig?

Eine Sperre kann parallele Verarbeitungen verhindern. Gegen einen späteren Wiederholungsversuch nach Ablauf der Sperre hilft sie allein nicht. Dafür brauchst du zusätzlich einen stabilen Aktionsschlüssel und eine idempotente Verarbeitung.

Wie verhindere ich doppelt verschickte E-Mails?

Ordne jedem beabsichtigten Versand einen eindeutigen Aktionsschlüssel zu. Nutze diesen als Idempotenzschlüssel beim E-Mail-Dienst, sofern er das unterstützt, und speichere Versandversuche mit externer Nachrichten-ID. Bei unklarem Ergebnis sollte der Vorgang geprüft statt blind erneut gesendet werden.