N8n 2.30.4 – Fehlenden Node sicher mit ursprünglicher ID und Versionenschutz wiederherstellen

Hallo n8n-Community,

Wir benötigen Anleitung zum sicheren Reparieren eines bestehenden Workflows in self-hosted n8n 2.30.4, ohne das Risiko unbeabsichtigter Änderungen.

Aktuelle Situation

  • Der Workflow ist inaktiv und nicht veröffentlicht.
  • Er enthält derzeit 26 Knoten.
  • Ein Data Table-Knoten (n8n-nodes-base.dataTable, typeVersion 1.1) fehlt.
  • Der ursprüngliche fehlende Knoten hat die ID b4-17.
  • Wir haben Sicherungen des aktuellen Workflows und des ursprünglichen 27-Knoten-Designs verifiziert.
  • Nur der fehlende Knoten und seine zwei Verbindungen sollten wiederhergestellt werden.
  • Alle bestehenden Knoten, Anmeldedaten, Webhook-Pfade, Workflow-Einstellungen und die Workflow-Identität müssen unverändert bleiben.

Ein früherer Versuch, ein partielles JSON-Fragment in den Editor einzufügen, hat unerwartet den Workflow-Titel geändert. Wir haben gestoppt und anschließend den beabsichtigten Titel wiederhergestellt.

Wir wollen diesen Ansatz nicht ohne zuverlässige Schutzmaßnahmen wiederholen.

Fragen

1. Wiederherstellen eines Knotens mit seiner ursprünglichen ID

Unterstützt der native n8n 2.30.4-Editor das Einfügen oder Wiederherstellen eines Knotens, während seine exakte ursprüngliche JSON-ID (b4-17) beibehalten wird?

Falls dies nicht unterstützt wird, ist die Beibehaltung der ursprünglichen Knoten-ID technisch notwendig, vorausgesetzt, der Knotenname, die Parameter, Ausdrücke und Verbindungen bleiben korrekt?

Gibt es interne Verweise oder Mechanismen, die von dieser ID abhängen könnten?

2. Versionskonflukt-Schutz

Schützt n8n 2.30.4 zuverlässig vor gleichzeitigen Änderungen beim Speichern eines Workflows über den Editor?

Bietet versionId für den API-Endpunkt PUT /api/v1/workflows/{id} effektives optimistisches Sperren in dieser spezifischen Version?

Die aktuelle API-Dokumentation verweist auf optimistisches Sperren, aber versionId erscheint auch als schreibgeschützt im Update-Schema. Wir würden eine Klarstellung zum tatsächlich unterstützten Verhalten schätzen.

3. Sicherste offiziell unterstützte Reparaturprozedur

Was ist der empfohlene Ansatz zum Wiederherstellen von genau einem fehlenden Knoten und seinen zwei Verbindungen in einem bestehenden inaktiven Workflow?

Unsere Prioritäten sind:

  • Beibehaltung der bestehenden Workflow-ID und des Titels.
  • Beibehaltung aller bestehenden Knoten und nicht verwandter Verbindungen.
  • Beibehaltung von Anmeldedaten, Webhook-Pfaden und Sicherheitseinstellungen.
  • Verhinderung unbeabsichtigter Aktivierung oder Veröffentlichung.
  • Erstellung eines vollständigen Vorher-Nachher-JSON-Vergleichs.
  • Vermeidung von Überschreibung gleichzeitiger Änderungen.

Würden Sie eine kontrollierte Editor-Operation oder ein API-Update für n8n 2.30.4 empfehlen?

Wir würden besonders Verweise auf offizielle Dokumentation oder den relevanten versionsspezifischen Quellcode schätzen.

Aus Sicherheitsgründen veröffentlichen wir nicht unser vollständiges Workflow-JSON, API-Schlüssel, Anmeldedaten oder interne Infrastrukturdetails.

Vielen Dank für Ihre Hilfe!

Hallo @Zafer_Imre, in 2.30.4 setzt der öffentliche PUT-Handler forceSave: true. Die Übergabe von versionId schützt daher nicht vor dem Überschreiben einer gleichzeitigen Änderung.

  1. Normales Einfügen aus der Zwischenablage regeneriert Node-IDs. Der Importer wendet auch einen Top-Level-name an, der den Workflow umbenennen kann. Gewöhnliche Verbindungen und Node-Namen-Ausdrücke verwenden Namen, daher ist b4-17 normalerweise nicht für das Routing erforderlich. IDs sind jedoch anderswo wichtig, beispielsweise in nodeGroups.nodeIds.

  2. Der Editor sendet expectedChecksum, aber der Controller umgeht diese Prüfung, wenn die Sharing-Unterstützung deaktiviert ist. Seine Checksum-Prüfung und das Datenbankupdate sind separate Operationen. Keine der beiden Routen gibt dir in dieser Version einen bedingungslosen atomaren versionId-Schutz.

  3. Wenn b4-17 beibehalten werden muss, würde ich die öffentliche API verwenden und alle anderen Editor-/API-Schreiber blockieren, wobei ich die Reparatur zunächst auf einer isolierten 2.30.4-Kopie durchspielen würde. Hole einen neuen GET des aktuellen 26-Node-Workflows und merge nur das ursprüngliche Node-Objekt, wobei du seine ID und typeVersion 1.1 sowie die zwei gewünschten Verbindungen beibehältst. Verwende das aktuelle Graph als Basis, anstatt es durch die alte 27-Node-Sicherung zu ersetzen. Überprüfe das gewünschte Diff vor dem Senden von PUT an die vorhandene Workflow-ID.

Der PUT-Body muss dem Schreibschema dieser Version entsprechen, einschließlich name, der vollständigen nodes und connections sowie settings; reiche nicht die gesamte GET-Antwort mit Metadaten ein, die nur gelesen werden können. Bestätige, dass activeVersionId null ist, bevor du aktualisierst: Diese Route republiziert einen bereits veröffentlichten Workflow, veröffentlicht aber keinen unveröffentlichten.

Hole ihn erneut ab und behalte das vollständige Before/After-JSON-Diff. Erwarte serververwaltete Revisions-/Zeitstempeländerungen; überprüfe, dass Titel, vorhandene Nodes, Anmeldeinformationsreferenzen, Webhook-Pfade, Einstellungen und unabhängige Verbindungen unverändert blieben. Ein GET/Vergleich vor PUT allein kann ein Rennen nicht verhindern. Wenn die ursprüngliche ID nicht erforderlich ist, ist das Neuerstellen des Nodes und seiner zwei Verbindungen im Editor einfacher.

2.30.4-Quelle:

Die sicherste Methode ist, das Einfügen in den Editor ganz zu vermeiden. Exportiere den Workflow als JSON, füge das Node-Objekt mit seiner ursprünglichen ID wieder in das nodes-Array ein, füge dann manuell seine zwei Einträge unter connections hinzu. Importiere das als neuen Workflow, vergleiche es mit deinem Backup, und tausche es erst dann aus.

Das Exportieren des rohen Workflow-JSON und das manuelle Einfügen des Node-Blocks mit seiner ursprünglichen ID bewahren alle nachgelagerten Pin-Referenzen und verhindern unterbrochene Verbindungslinien.

Das Testen des gepatchten Workflows auf einem duplizierten Entwurf vor dem Speichern von Änderungen am aktiven Workflow stellt sicher, dass du versehentliche Produktionsausfallzeiten vermeidest.