Menu
Feedback
Problemas conhecidos
Problema com a compatibilidade de versão do Node
Apps
ID: 1256617
Backlog
Publicado em16/10/2025
Última atualização em16/10/2025
1 min de leitura

Este problema conhecido foi traduzido automaticamente do inglês.

Sumário

Atualmente, nosso hub do construtor é executado na imagem 16.X, o que significa que só é possível criar bibliotecas compatíveis com essa versão. Os aplicativos que usam o builder 7 são executados no nó 20, mas o problema surge durante a criação, pois o hub do builder está sendo executado na versão 16, causando um problema de incompatibilidade.

Simulação

Ao tentar criar um aplicativo na VTEX. Por exemplo, o erro é o seguinte:

@vendor/app@1.X.X: O mecanismo "node" é incompatível com este módulo. Versão esperada ">=18.0.0". Obteve "16.X.X "Módulo incompatível encontrado.

O módulo requer a versão 18.0.0 ou superior do Node, mas a versão atual que está sendo usada pelo construtor é a 16.X.X

Workaround

Como o builder-hub está limitado ao Node 16.X, você precisa usar pacotes que tenham o mecanismo como node >= 16.X. Se estiver usando uma biblioteca específica, será necessário fazer o downgrade da versão da biblioteca para uma compatível.

Contribuidores
3
Photo of the contributor
Photo of the contributor
Photo of the contributor
+ 3 contributors
Isso foi útil?
Sim
Não
Sugerir edições (GitHub)
Contribuidores
3
Photo of the contributor
Photo of the contributor
Photo of the contributor
+ 3 contributors
Nesta página
Ainda tem dúvidas?
Pergunte à comunidade
Encontre soluções e compartilhe ideias na VTEX Community
Junte-se à nossa comunidade
Solicite suporte à VTEX
Receba assistência personalizada com nossos especialistas
Abra um ticket de suporte
GitHubDeveloper PortalComunidadeFeedback