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(ounpm ci) na pasta que contém opackage.json. - Confirme que o pacote está listado em
dependencies— se estiver só emdevDependencies, ele não será instalado quando se usanpm install --omit=devem produção. - Confira que você está rodando o Node na pasta certa e que a pasta
node_modulesexiste ao lado dopackage.json. - Em Docker, verifique se o
COPYe oRUN npm ciacontecem no estágio que roda a aplicação (em builds multi-stage, onode_modulesprecisa ser copiado para a imagem final).
3. Se é um caminho relativo (./ ou ../)
- Confira maiúsculas/minúsculas:
./Utilsfunciona 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 osrc/.
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.