n8n 2.30.4 – Restaurer en toute sécurité un nœud manquant avec protection de l'ID original et de la version

Bonjour à la communauté n8n,

Nous avons besoin de conseils pour réparer en toute sécurité un flux de travail existant dans n8n auto-hébergé 2.30.4, sans risquer des modifications involontaires.

Situation actuelle

  • Le flux de travail est inactif et non publié.
  • Il contient actuellement 26 nœuds.
  • Un nœud Data Table (n8n-nodes-base.dataTable, typeVersion 1.1) est manquant.
  • Le nœud manquant d’origine porte l’ID b4-17.
  • Nous avons vérifié les sauvegardes du flux de travail actuel et la conception originale à 27 nœuds.
  • Seul le nœud manquant et ses deux connexions doivent être restaurés.
  • Tous les nœuds existants, les identifiants, les chemins webhook, les paramètres du flux de travail et l’identité du flux de travail doivent rester inchangés.

Une tentative précédente de coller un fragment JSON partiel dans l’éditeur a modifié de manière inattendue le titre du flux de travail. Nous nous sommes arrêtés et avons ensuite restauré le titre prévu.

Nous ne voulons pas répéter cette approche sans des mesures de sécurité fiables.

Questions

1. Restauration d’un nœud avec son ID d’origine

L’éditeur natif n8n 2.30.4 supporte-t-il l’insertion ou la restauration d’un nœud tout en préservant son ID JSON d’origine exact (b4-17) ?

Si ce n’est pas supporté, est-il techniquement nécessaire de préserver l’ID de nœud d’origine, à condition que le nom du nœud, les paramètres, les expressions et les connexions restent corrects ?

Y a-t-il des références internes ou des mécanismes qui pourraient dépendre de cet ID ?

2. Protection contre les conflits de version

n8n 2.30.4 protège-t-il de manière fiable contre les modifications concurrentes lors de l’enregistrement d’un flux de travail via l’éditeur ?

Pour le point de terminaison API PUT /api/v1/workflows/{id}, versionId fournit-il un verrouillage optimiste efficace dans cette version spécifique ?

La documentation actuelle de l’API fait référence au verrouillage optimiste, mais versionId apparaît également comme en lecture seule dans le schéma de mise à jour. Nous apprécierions une clarification sur le comportement réellement supporté.

3. Procédure de réparation officiellement supportée la plus sûre

Quelle est l’approche recommandée pour restaurer exactement un nœud manquant et ses deux connexions dans un flux de travail inactif existant ?

Nos priorités sont :

  • Préserver l’ID et le titre du flux de travail existant.
  • Préserver chaque nœud existant et chaque connexion non liée.
  • Préserver les identifiants, les chemins webhook et les paramètres de sécurité.
  • Empêcher l’activation ou la publication involontaires.
  • Créer une comparaison JSON complète avant et après.
  • Éviter de remplacer les modifications concurrentes.

Recommanderiez-vous une opération d’éditeur contrôlée ou une mise à jour API pour n8n 2.30.4 ?

Nous apprécierions particulièrement les références à la documentation officielle ou au code source pertinent spécifique à la version.

Pour des raisons de sécurité, nous ne publions pas notre JSON de flux de travail complet, nos clés API, nos identifiants ou nos détails d’infrastructure interne.

Merci de votre aide !

Bonjour @Zafer_Imre, dans la version 2.30.4, le gestionnaire public PUT définit forceSave: true. Passer versionId ne protège donc pas contre l’écrasement d’une modification concurrente.

  1. Le collage normal du presse-papiers régénère les ID de nœud. L’importateur applique également un name de niveau supérieur, qui peut renommer le flux de travail. Les connexions ordinaires et les expressions de nom de nœud utilisent des noms, donc b4-17 n’est normalement pas nécessaire pour le routage. Les ID continuent d’avoir de l’importance ailleurs, par exemple dans nodeGroups.nodeIds.

  2. L’éditeur envoie expectedChecksum, mais le contrôleur contourne cette vérification lorsque la prise en charge du partage est désactivée. Sa vérification de checksum et sa mise à jour de base de données sont des opérations distinctes. Aucune route ne vous donne une garde versionId atomique inconditionnelle dans cette version.

  3. Si b4-17 doit être conservé, j’utiliserais l’API publique avec tous les autres writers éditeur/API bloqués, en répétant d’abord la réparation sur une copie isolée de 2.30.4. Prenez un GET frais du flux de travail actuel de 26 nœuds et fusionnez uniquement l’objet nœud original, en préservant son ID et typeVersion 1.1, plus les deux connexions prévues. Utilisez le graphe actuel comme base, plutôt que de le remplacer par la sauvegarde ancienne de 27 nœuds. Examinez le diff prévu avant d’envoyer PUT à l’ID de flux de travail existant.

Le corps PUT doit suivre le schéma inscriptible de cette version, y compris name, les nodes et connections complets, et settings ; ne soumettez pas la réponse GET complète avec les métadonnées en lecture seule. Confirmez que activeVersionId est null avant la mise à jour : ce chemin réédite un flux de travail déjà publié, mais ne publie pas un flux non publié.

Obtenez-le à nouveau et conservez le diff JSON avant/après complet. Attendez-vous à des modifications de révision/timestamp gérées par le serveur ; vérifiez que le titre, les nœuds existants, les références d’accréditation, les chemins de webhook, les paramètres et les connexions non liées sont restés inchangés. Un GET/compare avant PUT seul ne peut pas prévenir une course. Si l’ID original n’est pas requis, recréer simplement le nœud et ses deux connexions dans l’éditeur est plus simple.

Source 2.30.4 :

Le moyen le plus sûr est de contourner complètement le collage dans l’éditeur. Exportez le JSON du flux de travail, rajoutez l’objet nœud dans le tableau nodes avec son id original, puis ajoutez manuellement ses deux entrées sous connections. Importez-le en tant que nouveau flux de travail, comparez-le avec votre sauvegarde, et seulement après permutez-le.

exporter le JSON du workflow brut et insérer manuellement le bloc de nœud avec son identifiant original préserve toutes les références des broches en aval et évite les lignes de connexion cassées.

tester le workflow corrigé sur un brouillon dupliqué avant d’enregistrer les modifications dans le workflow actif garantit que vous évitez les interruptions de production accidentelles.