Preguntas frecuentes y solución de problemas de n8n

El flujo de trabajo no se ejecuta automáticamente

• ¿Has pulsado Publish (en n8n 1.x, el interruptor Active)? Pulsar solo Save no activa los disparadores.
• ¿Lo has vuelto a publicar después de modificarlo?
• ¿La hora de la programación es correcta? Consulta la pregunta siguiente.
• Ve a Executions para comprobar si hay ejecuciones fallidas.

La hora programada tiene una diferencia de 8 horas

No se ha configurado la zona horaria de n8n, por lo que se usa UTC de forma predeterminada. Configura la variable de entorno GENERIC_TIMEZONE=Asia/Taipei y reinicia n8n, o especifica la zona horaria en Settings → Timezone del flujo de trabajo.

La URL de Webhook muestra localhost

Añade la URL pública a la configuración de despliegue:

N8N_WEBHOOK_URL=https://n8n.example.com/

(Las versiones anteriores a n8n 2.30 usan WEBHOOK_URL.) Comprueba también que N8N_HOST y N8N_PROTOCOL sean correctos. Consulta Despliegue autohospedado.

Webhook devuelve 404

• Si usas Test URL, primero debes pulsar Listen for test event, y solo se puede recibir un evento.
• Si usas Production URL, el flujo de trabajo debe estar publicado.
• Comprueba que el método HTTP (GET / POST) coincida con la configuración.

Consulta Tutorial de Webhook.

Un nodo se ejecuta muchas veces

El nodo anterior ha generado varios items, por lo que el nodo siguiente se ejecuta una vez por cada uno. Si no quieres que se repita, activa Execute Once en Settings del nodo o combina primero los datos con Aggregate. Consulta Estructura de datos e items.

Error de autorización de Google: redirect_uri_mismatch

El «URI de redireccionamiento autorizado» configurado en Google Cloud no coincide con la URL OAuth Redirect que muestra n8n. Copia la URL de la pantalla de credenciales de n8n y pégala completa en Google Cloud. Si n8n muestra localhost, corrige primero la URL de despliegue. Consulta Gestión de credenciales.

La autorización de Google deja de funcionar cada pocos días

Cuando la aplicación OAuth de Google Cloud está en estado «Prueba», la autorización tiene una validez más corta. Puedes publicar la aplicación como versión de producción.

Error de secure cookie al conectarse desde otro ordenador

Esto ocurre al conectarse desde una dirección que no es localhost mediante http:// (sin HTTPS). Para usarlo en producción, configura HTTPS; si solo estás haciendo pruebas en una red interna, puedes configurar temporalmente N8N_SECURE_COOKIE=false.

Memoria insuficiente (JavaScript heap out of memory)

Suele ocurrir al procesar demasiados datos o archivos demasiado grandes de una sola vez:

• Procesa los datos por lotes con Loop Over Items.
• Divide el flujo en subflujos (la memoria se libera cuando termina el subflujo).
• Conserva solo los campos necesarios (activa Keep Only Set Fields en Edit Fields).
• Aumenta la memoria del host.

La base de datos no deja de crecer

Los registros de ejecución guardan los datos completos de cada nodo. Configura la limpieza automática:

EXECUTIONS_DATA_PRUNE=true
EXECUTIONS_DATA_MAX_AGE=168    # conservar 7 días (unidad: horas)

También puedes configurar en Settings del flujo de trabajo que no se guarden los datos de las ejecuciones correctas.

Una expresión muestra undefined o un error

• Ejecuta primero el nodo anterior para que la vista previa de la expresión tenga datos.
• Usa ?. para evitar errores cuando no existe un nivel intermedio: {{ $json.address?.city }}.
• Para leer un nodo anterior, usa $('Nombre del nodo') en lugar de $json.

Consulta Tutorial de expresiones.

El nodo Code no puede leer $env

De forma predeterminada, n8n 2.x impide que el nodo Code lea variables de entorno. Se recomienda guardar los valores necesarios como credenciales o pasarlos mediante los parámetros del nodo.

El flujo de trabajo dejó de funcionar después de actualizar

Revisa los cambios incompatibles en las notas de la versión. Si no puedes corregirlo de inmediato, puedes volver a una versión anterior de la imagen y restaurar una copia de seguridad de la base de datos (las migraciones de la base de datos normalmente no se pueden revertir, por eso es importante hacer una copia de seguridad antes de actualizar). Consulta Copias de seguridad y actualizaciones.

¿Dónde puedo encontrar ejemplos?

• La página Templates del sitio oficial de n8n ofrece miles de plantillas de flujos de trabajo compartidas por la comunidad que puedes importar y usar directamente.
• El foro oficial de la comunidad de n8n tiene muchas preguntas y respuestas. Si aparece un mensaje de error, puedes buscarlo allí primero.

Actualizado 12 de octubre de 2026