Introducción
En cualquier flujo de producción, las cosas saldrán mal. Una API devuelve un 500, un payload de webhook está mal formado, una conexión a la base de datos se agota. La pregunta no es si ocurren fallos, sino si tu flujo los maneja de forma elegante o si silenciosamente deja caer la pelota.
n8n te ofrece dos capas de manejo de errores: manejo de errores local a nivel de nodo y un nodo dedicado Error Trigger que te permite construir un flujo separado específico para capturar y responder a fallos. Esta lección cubre ambas, con énfasis en obtener alertas reales en tus manos cuando algo falla.
Cómo maneja n8n los fallos de nodos por defecto
Por defecto, cuando un nodo lanza un error, n8n detiene la ejecución para esa ruta y marca la ejecución como fallida. Verás el error en el historial de ejecuciones, pero no ocurre nada proactivo — no hay alerta, no hay reintento, no hay respaldo.
Para cada nodo, puedes cambiar este comportamiento en el panel de configuración del nodo. Las tres opciones más útiles son:
Detener el flujo ante el error — el comportamiento por defecto. La ejecución se detiene en el nodo fallido.
Continuar ante el error — n8n continúa la ejecución aunque el nodo falle. El elemento de salida del nodo fallido llevará información de error en un campo especial, que puedes inspeccionar aguas abajo.
Reintentar ante fallo — n8n reintenta automáticamente el nodo un número configurable de veces con un retraso entre intentos. Esto es útil para fallos transitorios como respuestas de límite de tasa o llamadas de red inestables.
Para configurar estos, abre cualquier nodo, ve a Configuración y busca la sección "On Error". Para reintentos, también establece "Retry On Fail" en true y define "Max Tries" y "Wait Between Tries" en milisegundos.
Continue on error es especialmente poderoso cuando quieres procesar un lote de elementos y no dejar que un único registro defectuoso termine con toda la ejecución. El nodo descendente recibe un elemento que se ve así:
Luego puedes usar un nodo IF para verificar si el elemento tiene un campo de error y enrutarlo hacia una rama separada para registro o alertas.
Configurando un Error Workflow con el disparador de Error
La configuración a nivel de nodo maneja fallos individuales de nodos, pero ¿qué pasa con capturar cualquier fallo en todo el flujo de trabajo? Eso es para lo que sirve el nodo Error Trigger.
El Error Trigger funciona a nivel de flujo de trabajo. Creas un flujo de trabajo separado —llámalo algo como "Global Error Handler"— y configuras su disparador como Error Trigger. Luego, en cualquier otro flujo de trabajo, vas a Configuración y defines el campo "Error Workflow" para apuntar a este flujo de manejo.
Cuando el flujo de trabajo padre falla, n8n automáticamente inicia el flujo de manejo de errores y le pasa una carga útil con detalles de lo que salió mal. La estructura de la carga útil se ve así:
Esto te da todo lo que necesitas: qué flujo de trabajo falló, qué nodo fue el último en ejecutarse, el mensaje de error y un enlace directo al registro de ejecución.
Para configurar el flujo de trabajo de Error Trigger:
1. Crea un nuevo flujo de trabajo y añade el nodo Error Trigger como nodo inicial. 2. Agrega cualquier paso de alerta que necesites — Slack, correo, PagerDuty, o una solicitud HTTP a un webhook. 3. Guarda y publica el flujo de trabajo. 4. En tus flujos de producción, abre Configuración y establece "Error Workflow" a este manejador.
Puedes configurar un manejador de errores global y reutilizarlo en todos los flujos de tu instancia.
Enviar alertas cuando algo sale mal
La acción más común en un flujo de errores es enviar una notificación. Aquí hay un ejemplo que publica un mensaje en un canal de Slack usando los datos del Error Trigger:
Si prefieres usar el nodo HTTP Request para llamar directamente a un webhook de Slack:
Para las alertas por correo electrónico a través del nodo Send Email, mapea los campos de error en el asunto y el cuerpo de la misma manera. La clave es que cada campo de la carga útil del Error Trigger es accesible a través de la sintaxis de expresiones normal.
También puedes añadir un nodo Set antes de tu paso de alerta para dar forma o enriquecer los datos — por ejemplo, añadiendo un nivel de severidad basado en el nombre del flujo de trabajo, o añadiendo una marca de tiempo.
Errores comunes
Apuntar el flujo de errores hacia sí mismo — si tu flujo de manejo de errores también falla, n8n no lo activará recursivamente de nuevo, pero perderás visibilidad. Mantén los flujos de manejo de errores simples y con pocas dependencias.
Olvidar publicar el manejador de errores — un flujo de trabajo configurado como el Error Workflow debe estar activo. Si se guarda como borrador, no se ejecutará.
Usar Continue on Error en todas partes — esto puede ocultar fallos reales. Reservalo para casos en los que tengas lógica descendente explícita para manejar el ítem de error. No lo uses como una forma de silenciar errores que no quieres tratar.
No probar la ruta de error — crea un flujo de prueba con una falla deliberada (un nodo HTTP Request que apunte a una URL que devuelve 500) y verifica que tu manejador de errores realmente se dispare y envíe la alerta que esperas.
Resumen
Los ajustes a nivel de nodo te permiten controlar el comportamiento ante fallos individuales: detenerse, continuar o reintentar. El nodo Error Trigger te permite construir un manejador centralizado que se activa cada vez que falla cualquier flujo enlazado, proporcionándote el contexto de ejecución que necesitas para enviar una alerta significativa. En conjunto, estas dos capas cubren la gran mayoría de las necesidades de manejo de errores en producción en n8n sin requerir código personalizado.
Punto de control de la lección
Repasa lo aprendido y recibe comentarios sobre tu trabajo.