@kjooleng et @ClearStack ont tous les deux mis dans le mille concernant le crash OOM et le danger des envois d’e-mails en doublon.
Lorsque vous traitez 1000 éléments dans une exécution linéaire unique ou une boucle, Node.js accumule tous les états d’entrée/sortie des nœuds en mémoire. Le garbage collection ne peut pas nettoyer les objets tant que l’exécution complète du workflow parent n’est pas terminée, ce qui entraîne des arrêts OOM de l’hôte.
Voici le modèle de production en 3 étapes pour résoudre à la fois la fuite mémoire et le risque d’envoi d’e-mails en doublon :
### 1. Le modèle de traitement par lot de sous-workflows (résout OOM)
Au lieu d’exécuter les 1000 prospects dans une seule boucle du workflow parent :
1. Utilisez un **Split In Batches Node** (taille de lot : 50-100 éléments).
2. Passez chaque lot à un workflow worker secondaire en utilisant le **Execute Workflow Node**.
3. **Pourquoi cela fonctionne :** Quand chaque exécution de sous-workflow se termine, n8n vide immédiatement son empreinte RAM et déclenche le garbage collector de Node.js, en maintenant l’utilisation mémoire stable sur une exécution de 6 heures.
### 2. Vérification d’idempotence (prévient le spam d’e-mails en doublon)
Comme l’a souligné @ClearStack, si l’exécution #1 échoue au prospect 260 et que vous recommencez, les prospects 1-260 reçoivent des e-mails deux fois.
* À l’intérieur de votre sous-workflow, juste avant le nœud d’envoi d’e-mail, ajoutez un **If / Filter Node** qui vérifie `already_contacted === true` (ou interroge votre BD pour `email_sent_at IS NOT NULL`).
* Si `true` → Ignorer.
* Si `false` → Envoyer l’e-mail et mettre à jour immédiatement le statut de la BD à `contacted`.
### 3. Augmenter la limite de heap de Node.js (si auto-hébergé / Docker)
Si vous auto-hébergez n8n via Docker ou PM2, la limite de mémoire heap par défaut de Node.js est d’environ 2 GB. Pour les tâches de traitement par lot longue durée, augmentez-la dans vos variables d’environnement :
```bash
NODE_OPTIONS=“–max-old-space-size=4096”
```
*(Cela alloue jusqu’à 4 GB de RAM au processus n8n).*
Combiner **sous-workflows + traitement par lot + vérifications d’idempotence pré-envoi** est la manière standard d’exécuter des pipelines de 10k+ prospects sans bloquer n8n ou spammer les utilisateurs.