Errores habituales de migración y cómo solucionarlos

Los errores más habituales tras migrar a n8n

1. «Workflow could not be activated» o el webhook no recibe datos

Causa: la app de origen sigue apuntando a la URL del webhook de prueba, o el workflow no está activo.

Solución: los webhooks de n8n tienen una Test URL (solo funciona mientras hace clic en «Listen for test event») y una Production URL (solo funciona con el workflow activo). Active el workflow y pegue la Production URL en la app de origen. En n8n autoalojado, defina WEBHOOK_URL para que n8n muestre su dominio público y no localhost.

2. Las programaciones se ejecutan a la hora equivocada

Causa: la zona horaria no está configurada.

Solución: defina GENERIC_TIMEZONE (autoalojado) o la zona horaria del workflow en Workflow settings.

3. Los nodos se ejecutan demasiadas (o muy pocas) veces

Causa: no entender bien los items. n8n ejecuta cada nodo una vez por item de entrada. Un paso «Looping» migrado o un iterador de Make añadido encima provoca un procesamiento doble.

Solución: elimine los bucles innecesarios. Use Aggregate para combinar items cuando necesite una sola salida (por ejemplo, un mensaje de Slack que resuma 20 filas), o active Execute Once en un nodo.

4. «Cannot read properties of undefined» en las expresiones

Causa: el campo al que se hace referencia no existe en algunos items, o ha referenciado el nodo equivocado.

Solución: use encadenamiento opcional y valores por defecto: {{ $json.customer?.email ?? '' }}. Haga referencia explícita a nodos anteriores: {{ $('Stripe Trigger').item.json.data.object.id }}.

5. Errores de OAuth: «invalid_grant», «redirect_uri_mismatch», tokens que caducan

Causas y soluciones:

• redirect_uri_mismatch: la URL de redirección en la consola de desarrolladores de la app debe coincidir exactamente con la que muestra la credencial de n8n (https, dominio, ruta).
• invalid_grant a los 7 días (Google): su app OAuth de Google está en modo «Testing». Publíquela o use una app Internal en Google Workspace.
• Faltan scopes: añada los scopes necesarios y vuelva a conectar la credencial.

Consulte la guía de credenciales.

6. Registros duplicados tras el cambio

Causa: el Zap o escenario antiguo y el nuevo workflow se ejecutaron a la vez, o un webhook se reenvió.

Solución: desactive la automatización antigua en el mismo momento en que active la nueva. Use upserts (crear o actualizar) y guarde los ID externos para que los workflows sean idempotentes.

7. Los formatos de fecha no coinciden con los de Zapier

Causa: el Formatter de Zapier devolvía un formato concreto; n8n devuelve fechas ISO.

Solución: formatee de forma explícita: {{ $json.date.toDateTime().toFormat('dd/MM/yyyy') }}.

8. Faltan archivos binarios (adjuntos, PDF)

Causa: los datos del archivo están en la propiedad binary del item, no en el JSON, y un nodo intermedio los ha descartado.

Solución: compruebe el nombre de la propiedad binaria (por ejemplo attachment_0 o data) e indíquelo en el nodo que la recibe. Algunos nodos (como Edit Fields) necesitan activar «Include binary data».

9. Errores de límite de peticiones (429)

Causa: n8n procesa los items rápido y alcanza límites de API que el sondeo más lento de Zapier evitaba.

Solución: active Retry On Fail con una espera entre intentos, use Loop Over Items con un tamaño de lote y un nodo Wait, o las opciones de lotes del propio nodo.

10. La instancia autoalojada se queda sin memoria

Causa: archivos grandes, payloads JSON voluminosos o muchas ejecuciones simultáneas en un servidor pequeño.

Solución: aumente la RAM, procese los datos por lotes, evite mantener binarios grandes en memoria (use el modo binario «filesystem») o pase al queue mode con workers.

Hábitos de depuración que ahorran horas

• Fije los datos del trigger mientras construye para poder volver a ejecutar sin nuevos eventos.
• Abra las ejecuciones fallidas y revise la entrada y la salida del primer nodo en rojo.
• Añada un workflow con Error Trigger que publique los fallos en Slack con el nombre del workflow y un enlace.

Artículos relacionados

• Guía de migración de Zapier a n8n
• Chuleta de equivalencias