~ / hub / erros / Error: Cannot find module no Node.js
4 out 2026errosguia de solução

Error: Cannot find module no Node.js

Dependência faltando, caminho errado ou ESM/CommonJS misturados.

1. Leia a mensagem inteira

Error: Cannot find module 'express'
Require stack:
- /app/src/server.js

O nome entre aspas é o que o Node procurou. A Require stack diz qual arquivo pediu. Dois casos bem diferentes: nome de pacote (express) ou caminho relativo (./utils/format).

2. Se é um pacote (sem ./ no início)

  • Rode npm install (ou npm ci) na pasta que contém o package.json.
  • Confirme que o pacote está listado em dependencies — se estiver só em devDependencies, ele não será instalado quando se usa npm install --omit=dev em produção.
  • Confira que você está rodando o Node na pasta certa e que a pasta node_modules existe ao lado do package.json.
  • Em Docker, verifique se o COPY e o RUN npm ci acontecem no estágio que roda a aplicação (em builds multi-stage, o node_modules precisa ser copiado para a imagem final).

3. Se é um caminho relativo (./ ou ../)

  • Confira maiúsculas/minúsculas: ./Utils funciona no Windows e macOS, mas falha em Linux, onde o sistema diferencia.
  • Em ESM ("type": "module" no package.json), imports relativos exigem a extensão: import x from './utils.js'.
  • Em arquivos compilados (TypeScript), o caminho deve apontar para a saída (dist/), não para o src/.

4. Reinstalação limpa

rm -rf node_modules
npm ci                 # usa package-lock.json e instala versões exatas
# se ainda falhar:
npm cache verify

Evite apagar o package-lock.json sem motivo: ele garante que todos instalem as mesmas versões.

5. CommonJS x ESM

Misturar require() com import gera erros diferentes (como ERR_REQUIRE_ESM), mas também pode parecer “módulo não encontrado”. Padronize o projeto em um formato e use .mjs/.cjs apenas quando necessário.

DICA Para ver onde o Node procura, rode node -e "console.log(require.resolve.paths('express'))". Se o erro vier da instalação de peers, veja npm peer deps.

Continue explorando

← erros · npm peer deps · Node.js · npm · Roadmap Node.js

Veja também o hub de conteúdo, o glossário e os cursos gratuitos.

Quer aplicar no seu time?

Diagnóstico gratuito de 30 minutos.

solicitar →