debugging-executions

Par n8n-io · n8n

Déboguez les exécutions de workflow en échec ou produisant des résultats incorrects à l'aide des outils d'exécution. Chargez ce module lorsque l'utilisateur signale des échecs d'exécution, des sorties de nœud inattendues ou des valeurs de paramètres vides après une exécution réussie.

npx skills add https://github.com/n8n-io/n8n --skill debugging-executions

Déboguer les exécutions

Utilisez cette skill pour déboguer les défaillances d'exécution de workflow ou les exécutions réussies avec des valeurs incorrectes ou vides.

Tester les workflows déclenchés par événement

Utilisez executions(action="run") avec inputData correspondant à la forme de sortie du trigger — ne reconstituez pas le workflow avec un Manual Trigger. Pour les formes inputData du trigger, consultez knowledge-base/reference/trigger-input-data-shapes.md quand un sandbox workspace est disponible.

Exécution défaillante

executions(action="debug") inclut déjà failedNode.resolvedParameters — commencez par là. Ce bundle contient parameters (brutes, avec expressions intactes), resolved (substituées), failedExpressions (celles qui ont levé une exception), et emptyResolutions (celles qui ont silencieusement résolu à null/undefined/""). L'expression fautive est généralement visible sans appel de suivi. Les entrées dans l'une ou l'autre liste avec le tag reason: "unreconstructable-context" ne sont PAS des bugs réels — elles font référence à des variables que nous ne reconstituons pas en replay ($vars, $secrets, $response, $request, $pageCount, $ai). La valeur existait au moment de l'exécution ; nous ne l'avons simplement pas ici.

Exécution réussie avec valeur incorrecte ou vide

Quand debug ne s'applique pas parce que rien n'a levé d'erreur, appelez executions(action="get-resolved-node-parameters", executionId, nodeName) sur le nœud dont la sortie semble incorrecte — faites-le de votre propre initiative, ne demandez pas la permission à l'utilisateur d'abord. C'est une inspection peu coûteuse et en lecture seule, et c'est le seul moyen fiable de confirmer si une valeur vide provient d'une expression qui s'est silencieusement résolue à nullish. Vérifiez d'abord emptyResolutions ; la plupart des cas « ce paramètre est vide » sont des expressions qui se résolvent à null/undefined/"", pas des erreurs levées.

Skills similaires