A versão da API "5.4.296" não corresponde à versão do Worker "5.3.31"

A versão da API “5.4.296” não corresponde à versão do Worker “5.3.31”…estou recebendo este erro,tentei tanto em self host quanto em cloud

Olá Team, estou recebendo o erro acima

Descreva o problema/erro/pergunta

A versão da API “5.4.296” não corresponde à versão do Worker “5.3.31”…estou recebendo este erro,tentei tanto em self host quanto em cloud

Qual é a mensagem de erro (se houver)?

A versão da API “5.4.296” não corresponde à versão do Worker “5.3.31”…estou recebendo este erro,tentei tanto em self host quanto em cloud

Por favor, compartilhe seu workflow


(Selecione os nós em sua tela e use os atalhos de teclado CMD+C/CTRL+C e CMD+V/CTRL+V para copiar e colar o workflow.)

Compartilhe a saída retornada pelo último nó

{
“errorMessage”: “A versão da API "5.4.296" não corresponde à versão do Worker "5.3.31".”,
“errorDescription”: “A versão da API "5.4.296" não corresponde à versão do Worker "5.3.31".”,
“errorDetails”: {},
“n8nDetails”: {
“time”: “8/6/2026, 21:14:28”,
“n8nVersion”: “2.23.2 (Auto-hospedado)”,
“binaryDataMode”: “filesystem”
}
}

Informações sobre sua configuração n8n

  • versão n8n: mais recente
  • Banco de dados (padrão: SQLite): pinecone
  • configuração n8n EXECUTIONS_PROCESS (padrão: own, main): own
  • Executando n8n via (Docker, npm, n8n cloud, aplicativo de desktop): docker
  • Sistema operacional: Windows 11

Oi @Sameer_Kalkeri

Primeiramente, é importante saber que esse erro não é realmente um problema com sua instalação geral do n8n ou com seu servidor. Na verdade, trata-se de um conflito que está acontecendo dentro de uma “mini-ferramenta” específica que o n8n usa para ler e processar arquivos PDF. Essa ferramenta é como um tradutor que ajuda o n8n a entender o conteúdo de um documento PDF.

O problema ocorre porque duas partes diferentes do seu sistema estão usando versões diferentes dessa ferramenta de PDF. Normalmente, o n8n tem sua própria versão integrada, mas se você instalou um “Community Node” (como o Tesseract para OCR), esse complemento geralmente traz sua própria versão mais recente. Quando o n8n tenta processar um arquivo, essas duas versões entram em conflito e o sistema fica confuso.

Os termos técnicos “versão da API” e “versão do Worker” essencialmente se referem a um gerenciador e um trabalhador. Imagine um gerenciador dando instruções em um idioma (Versão 5.4), mas o trabalhador entende apenas uma versão um pouco mais antiga do idioma (Versão 5.3). Como eles não estão falando exatamente a mesma versão do idioma, eles não conseguem se comunicar e o processo falha.

Para corrigir isso, a solução mais fácil é procurar por qualquer nó instalado pela comunidade relacionado a PDF ou OCR, especificamente o nó Tesseract. Se você tem o Tesseract instalado, tente fazer downgrade para a versão 1.3.0. Essa versão mais antiga não usa a ferramenta de PDF conflitante, o que remove o conflito e permite que seu workflow execute sem problemas novamente.

No seu caso específico, como você está baixando arquivos do Google Drive e os enviando para um Vector Store, você provavelmente está processando PDFs. Como esse conflito acontece globalmente em toda sua instância do n8n, mesmo que você não esteja usando o nó Tesseract nesse workflow específico, ter ele instalado em qualquer lugar da sua conta pode desencadear esse erro.

Isso ajuda?

oi @Sameer_Kalkeri
de acordo com o github, esse erro foi coberto pela release 2.23.4, qual a sua versão atual ?
após confirmar a versão estável, não use a Beta, despublique, desative os nós, ative novamente e publique. nos retorne com a resposta por favor.

não tenho nenhum tesseract instalado.. e tentei tanto na versão cloud quanto na self-hosted

já fiz isso, tentei tanto em self hosted quanto na nuvem e continuo recebendo o mesmo erro

perfeito @Sameer_Kalkeri
compartilha por favor o seu workflow, copia e cola ele aqui sem os dados sensíveis.

@Sameer_Kalkeri

por favor clique em cada node com o simbolo vermelho e mande a fotografia de cada um

here you go:

@Sameer_Kalkeri
obrigada por compartilhar!

atualize todos os serviços para a mesma imagem, reinicie todos os containers docker compose pull docker compose up -d , e confirme que todos são da mesma versão docker compose ps
docker exec -it <container_n8n> n8n --version
docker exec -it <container_worker> n8n --version

Default Data Loader node documentation | n8n Docs

nos avise se deu certo.

Obrigado, reiniciei…funcionou.. agora está dando erro de dommatrix.

@Sameer_Kalkeri isso é falha na biblioteca que lê PDF no ambiente Node.js/self-hosted.

So what i need to do?

@Sameer_Kalkeri
use a versão 1.100.1 do n8n

por que eu deveria fazer downgrade?

iso vai impactar meus outros fluxos de trabalho

Este erro é uma incompatibilidade de versão entre seus componentes n8n em modo fila. O processo principal está na versão 5.4.296 e um worker está na 5.3.31. Em modo fila, a instância principal, os workers e qualquer processador de webhook devem executar exatamente a mesma versão do n8n, e aqui um deles não foi atualizado junto com o resto.

Solução: faça todos os containers executarem a mesma tag de imagem. Se você fixou uma versão no seu arquivo compose, atualize todas elas juntas (principal e workers) e recrie, ou se você está usando :latest, a causa usual é que um container puxou uma imagem mais nova que outro. Nesse caso, execute docker compose pull seguido de docker compose up -d --force-recreate em toda a stack para que todos caiam na mesma build. Após reiniciar, confirme que ambos reportam a mesma versão.

O que evitar no futuro: fixe uma tag de versão explícita em todos os componentes em vez de usar :latest, para que um pull parcial não deixe seus workers com uma versão atrás do seu processo principal. Incompatibilidades como esta podem fazer com que as execuções se comportem de forma inconsistente ou falhem de maneiras confusas, então vale a pena mantê-los travados na mesma versão. Você está usando Docker compose, e atualizou recentemente apenas parte da stack?

Oi @Sameer_Kalkeri,

Bem-vindo à comunidade!

Este problema parece similar a uma discussão anterior.

regressão conhecida desde o n8n 1.98 quando pdfjs-dist foi atualizado para uma versão que precisa de APIs de navegador como DOMMatrix — múltiplas issues abertas no github sobre isso (#16593, #16438, #16422).

Solução alternativa: Contorne o Document Loader para PDFs e use um nó Code com o pacote npm pdf-parse. Defina NODE_FUNCTION_ALLOW_EXTERNAL=pdf-parse nas suas variáveis de ambiente, extraia o texto no nó Code e passe o texto extraído diretamente para Vector Store Insert.

Seria ótimo se você pudesse compartilhar seu JSON de workflow para confirmar se está enfrentando o mesmo problema.

bem vindo à comunidade n8n @Sameer_Kalkeri
atualize sua instância para a v 2.23, confirme que a v do node.js é a mais atualizada, e se nada der certo considere usar um nó dedicado para extração de texto de PDFs (como PDF to Text) ou um nó de código utilizando bibliotecas como pdf-parse ou pdfjs-dist, que não dependem das APIs de navegador para funcionar.

sou iniciante, você poderia me guiar passo a passo…esses termos são muito técnicos

@Sameer_Kalkeri
como iniciante, é recomendado realizar o curso 1 e 2 da comunidade além de entender a documentação a seguir para te apoiar,

atualizar instância n8n Hosting Documentation and Guides | n8n Docs
substituir o antigo read pdf Extract From File | n8n Docs
exemplo para extração de texto de pdf oficial Extract text from a PDF file | n8n workflow template
se for usar o code node Code node documentation | n8n Docs
habilitar módulos externos Enable modules in Code node | n8n Docs

se puder, compartilhe seu json sem os dados sensíveis para entender melhor o seu caso.