DEV Community

Cover image for Erro "The engine node is incompatible with this module." "O nó do mecanismo é incompatível com este módulo" como resolver
Augusto Klecz
Augusto Klecz

Posted on • Edited on

1 1 1 1 1

Erro "The engine node is incompatible with this module." "O nó do mecanismo é incompatível com este módulo" como resolver

Caso você esteja enfrentando o erro "The engine node is incompatible with this module." e não saiba o que pode ter ocorrido, entenda que não é tão incomum quanto pode parecer.
 

Qual é a explicação do erro apresentado?

O erro geralmente acontece após a tentativa de instalação de uma versão recente de um pacote que você tentou incluir na sua aplicação. Quando você instala um pacote, a última versão disponível do pacote é baixada e colocada na pasta node_modules, e uma entrada correspondente é adicionada nos arquivos package.json e package-lock.json presentes na pasta atual.

O npm calcula as dependências e também instala a última versão delas.

E quando se enfrenta este erro de incompatibilidade, geralmente, como foi o meu caso, foi feita uma formatação do sistema, troca de sistema operacional no meio do desenvolvimento (caso você utilize um dual-boot) /ou uma grande atualização do Node.Js. Felizmente, podemos resolver este problema atualizando todos os pacotes e dependências globalmente.

Um exemplo real que aconteceu comigo, foi quando eu precisei iniciar uma aplicação que desenvolvi anteriormente em outro sistema operacional e o console me retornava um erro "The engine node is incompatible with this module. Expected version ^14.16.0 || ^16.10.0 || ^17.0.0 || ^18.0.0 || ^19.0.0. Got 20.9.0"

 

Solução

Para resolver este problema atualizando para uma versão major desses pacotes, instale o pacote npm-check-updates globalmente.

npm install -g npm-check-updates
Enter fullscreen mode Exit fullscreen mode

E depois, entrando na pasta da sua aplicação que possuiria a node_modules, aplique o seguinte comando:

ncu -u
Enter fullscreen mode Exit fullscreen mode

Este comando atualizará a sua package.json, as dependencies e devDependencies.

 
Após isso, faça a atualização utilizando o comando npm update e faça a reinstalação das dependências da aplicação. No meu caso, utilizei o gerenciador de pacotes yarn, então eu apliquei o comando de instalação.

yarn install // ou npm install
Enter fullscreen mode Exit fullscreen mode

 
Assim sendo, você resolve o erro com eficácia. Ah! e uma dica, para descobrir novas atualizações dos pacotes, você pode aplicar o comando npm outdated, este comando é responsável por verificar novas atualizações dos pacotes.

 
✅ Prontinho! espero que tenha conseguido solucionar esta questão utilizando esse artigo. Obrigado pela sua leitura até aqui.

 
Conheça a Cherry Code -> https://cherrycode.com.br

Sentry image

Hands-on debugging session: instrument, monitor, and fix

Join Lazar for a hands-on session where you’ll build it, break it, debug it, and fix it. You’ll set up Sentry, track errors, use Session Replay and Tracing, and leverage some good ol’ AI to find and fix issues fast.

RSVP here →

Top comments (0)

Sentry image

See why 4M developers consider Sentry, “not bad.”

Fixing code doesn’t have to be the worst part of your day. Learn how Sentry can help.

Learn more

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay