First Commit

10_n8n_nodes_a_risques.md

@@ -0,0 +1,74 @@
+# Nodes n8n à risque / vigilance
+
+Ce fichier recense les **nodes, fonctionnalités ou patterns n8n sensibles**,
+c’est-à-dire susceptibles de provoquer :
+
+- des bugs subtils,
+- des comportements inattendus,
+- des problèmes lors des upgrades.
+
+Dernière mise à jour : 2025-12-19
+
+---
+
+## Règles d’utilisation
+
+- On documente uniquement des cas vus en vrai (ou très probables + signalés).
+- Chaque entrée doit dire :
+  - ce qui peut mal se passer,
+  - comment on le voit (symptômes),
+  - comment on le maîtrise (mitigation).
+- Si c’est lié à une version : on note la version.
+
+---
+
+## IF Node
+
+### Risques
+
+- Comparaisons ambiguës entre `null`, `undefined`, `""` et `false`
+- Résultats surprenants si les types ne sont pas normalisés
+
+### Symptômes
+
+- Branche IF “inversée” par rapport à l’intuition
+- Cas limites qui passent en prod mais pas en test
+
+### Bonnes pratiques / mitigations
+
+- Normaliser les données avant comparaison (string/number/bool)
+- Tester explicitement `null` / `undefined`
+- Logguer la valeur et le type en amont si doute
+
+### Contexte technique
+
+- Observé : (à compléter quand tu as un cas précis)
+- n8n : (version à préciser)
+
+---
+
+## staticData (`$getWorkflowStaticData`)
+
+### Risques
+
+- Persistance entre exécutions (effet mémoire non voulu)
+- Dépendance forte à l’`executionId` si on fait de l’agrégation
+- Sensible aux upgrades n8n (comportements qui peuvent changer)
+
+### Symptômes
+
+- Données “fantômes” réutilisées
+- Résultats incohérents entre exécutions
+- Branches parallèles qui s’écrasent
+
+### Bonnes pratiques / mitigations
+
+- Toujours lier les données à `executionId`
+- Nettoyer/reset explicitement à chaque run
+- Documenter le pattern dès qu’il est utilisé
+- Préférer un stockage externe si l’état devient critique (DB/Redis/etc.)
+
+### Contexte technique
+
+- Validé : oui (usage avancé)
+- n8n : 1.121.2 / self-hosted / docker