La versión de API "5.4.296" no coincide con la versión de Worker "5.3.31"

La versión de API “5.4.296” no coincide con la versión de Worker “5.3.31”…estoy recibiendo este error,lo intenté en ambos host propio y nube

Hola Equipo, estoy recibiendo el error anterior

Describe el problema/error/pregunta

La versión de API “5.4.296” no coincide con la versión de Worker “5.3.31”…estoy recibiendo este error,lo intenté en ambos host propio y nube

¿Cuál es el mensaje de error (si lo hay)?

La versión de API “5.4.296” no coincide con la versión de Worker “5.3.31”…estoy recibiendo este error,lo intenté en ambos host propio y nube

Por favor, comparte tu flujo de trabajo


(Selecciona los nodos en tu lienzo y usa los atajos de teclado CMD+C/CTRL+C y CMD+V/CTRL+V para copiar y pegar el flujo de trabajo.)

Comparte el resultado devuelto por el último nodo

{
“errorMessage”: “La versión de API "5.4.296" no coincide con la versión de Worker "5.3.31".”,
“errorDescription”: “La versión de API "5.4.296" no coincide con la versión de Worker "5.3.31".”,
“errorDetails”: {},
“n8nDetails”: {
“time”: “6/8/2026, 9:14:28 PM”,
“n8nVersion”: “2.23.2 (Self Hosted)”,
“binaryDataMode”: “filesystem”
}
}

Información de tu configuración de n8n

  • versión de n8n: última
  • Base de datos (predeterminada: SQLite): pinecoine
  • Configuración de n8n EXECUTIONS_PROCESS (predeterminada: own, main): own
  • Ejecutando n8n a través de (Docker, npm, n8n cloud, aplicación de escritorio): docker
  • Sistema operativo: Windows 11

Hola @Sameer_Kalkeri

Primero, es importante saber que este error en realidad no es un problema con tu instalación general de n8n o con tu servidor. En cambio, es un conflicto que ocurre dentro de una “herramienta mini” específica que n8n usa para leer y procesar archivos PDF. Esta herramienta es como un traductor que ayuda a n8n a entender el contenido de un documento PDF.

El problema ocurre porque dos partes diferentes de tu sistema están utilizando versiones diferentes de esta herramienta PDF. Normalmente, n8n tiene su propia versión integrada, pero si has instalado un “Community Node” (como Tesseract para OCR), ese complemento a menudo trae su propia versión más nueva. Cuando n8n intenta procesar un archivo, estas dos versiones chocan, y el sistema se confunde.

Los términos técnicos “versión API” y “versión Worker” esencialmente se refieren a un gerente y un trabajador. Imagina a un gerente dando instrucciones en un idioma (Versión 5.4) pero el trabajador solo entiende un idioma ligeramente más antiguo (Versión 5.3). Debido a que no están hablando exactamente la misma versión del idioma, no pueden comunicarse, y el proceso falla.

Para solucionar esto, la solución más fácil es buscar cualquier nodo instalado de la comunidad relacionado con PDF u OCR, específicamente el nodo Tesseract. Si tienes Tesseract instalado, intenta degradarlo a la versión 1.3.0. Esta versión más antigua no utiliza la herramienta PDF conflictiva, lo que elimina el choque y permite que tu flujo de trabajo se ejecute sin problemas de nuevo.

En tu caso específico, dado que estás descargando archivos de Google Drive y enviándolos a un Vector Store, probablemente estés procesando PDFs. Debido a que este conflicto ocurre globalmente en toda tu instancia de n8n, incluso si no estás usando el nodo Tesseract en este flujo de trabajo específico, tenerlo instalado en cualquier lugar de tu cuenta puede desencadenar este error.

¿Te ayuda esto?

hola @Sameer_Kalkeri
de acuerdo con GitHub, este error fue cubierto por la versión 2.23.4, ¿cuál es tu versión actual?
después de confirmar la versión estable, no uses la Beta, despublica, desactiva los nodos, actívalos de nuevo y publica. por favor, cuéntanos cómo te va.

no tengo ningún tesseract instalado.. e intenté en ambos, en la nube y en uno autohospedado

ya lo hice, lo intenté tanto en self-hosted como en cloud y sigo obteniendo el mismo error

perfecto @Sameer_Kalkeri
comparte por favor tu workflow, cópialo y pégalo aquí sin los datos sensibles.

@Sameer_Kalkeri

por favor haz clic en cada nodo con el símbolo rojo y envía la fotografía de cada uno

here you go:

@Sameer_Kalkeri
¡gracias por compartir!

actualiza todos los servicios a la misma imagen, reinicia todos los contenedores docker compose pull docker compose up -d , y confirma que todos sean de la misma versión docker compose ps
docker exec -it <container_n8n> n8n --version
docker exec -it <container_worker> n8n --version

Documentación del nodo Default Data Loader | n8n Docs

cuéntanos si funcionó.

Gracias, lo reinicié… funcionó.. ahora estoy recibiendo un error de dommatrix.

@Sameer_Kalkeri eso es un fallo en la biblioteca que lee PDF en el entorno Node.js/auto-hospedado.

¿Entonces qué tengo que hacer?

@Sameer_Kalkeri
usa la versión 1.100.1 de n8n

¿por qué debería degradarlo?

impactará mis otros flujos de trabajo

Este error es un desajuste de versión entre tus componentes de n8n en modo de cola, el proceso principal está en 5.4.296 y un worker está en 5.3.31. En modo de cola, la instancia principal, los workers y cualquier procesador de webhook deben ejecutar exactamente la misma versión de n8n, y aquí uno de ellos no se actualizó junto con los demás.

Solución: haz que cada contenedor ejecute la misma etiqueta de imagen. Si fijaste una versión en tu archivo compose, incrementa todas juntas (principal y workers) y recrea, o si estás en :latest, la causa habitual es que un contenedor extrajo una imagen más nueva que otro, así que ejecuta docker compose pull y luego docker compose up -d --force-recreate en toda la pila para que todos lleguen a la misma compilación. Después del reinicio, confirma que ambos reporten la misma versión.

Lo que debes evitar en el futuro: fija una etiqueta de versión explícita en todos los componentes en lugar de :latest, para que una extracción parcial no deje a tus workers una versión atrás de tu proceso principal. Los desajustes como este pueden causar que las ejecuciones se comporten de manera inconsistente o fallen de forma confusa, así que vale la pena bloquearlos a la misma versión. ¿Estás en Docker compose, y actualizaste recientemente solo parte de la pila?

Hola @Sameer_Kalkeri,

¡Bienvenido a la comunidad!

Este problema parece similar a una discusión anterior.

regresión conocida desde n8n 1.98 cuando pdfjs-dist se actualizó a una versión que necesita APIs del navegador como DOMMatrix — hay múltiples issues abiertos en github al respecto (#16593, #16438, #16422).

Solución alternativa: Omite Document Loader para PDFs y utiliza un nodo Code con el paquete npm pdf-parse en su lugar. Establece NODE_FUNCTION_ALLOW_EXTERNAL=pdf-parse en tus variables de entorno, extrae el texto en el nodo Code y pasa el texto extraído directamente a Vector Store Insert.

Sería genial si pudieras compartir el JSON de tu flujo de trabajo para confirmar si estás enfrentando el mismo problema.

Bienvenido a la comunidad n8n @Sameer_Kalkeri
actualiza tu instancia a la v 2.23, confirma que la v de Node.js sea la más actualizada, y si nada funciona considera usar un nodo dedicado para extracción de texto de PDFs (como PDF to Text) o un nodo de código utilizando librerías como pdf-parse o pdfjs-dist, que no dependen de las APIs del navegador para funcionar.

Soy principiante, ¿podrías guiarme paso a paso… estos términos son demasiado técnicos

@Sameer_Kalkeri
como principiante, se recomienda realizar los cursos 1 y 2 de la comunidad además de entender la documentación a continuación para apoyarte,

actualizar instancia n8n Hosting Documentation and Guides | n8n Docs
reemplazar el antiguo read pdf Extract From File | n8n Docs
ejemplo para extracción de texto de pdf oficial Extract text from a PDF file | n8n workflow template
si vas a usar el code node Code node documentation | n8n Docs
habilitar módulos externos Enable modules in Code node | n8n Docs

si puedes, comparte tu json sin los datos sensibles para entender mejor tu caso.