O erro Uncaught Error: Cannot find module
geralmente acontece quando você tenta importar ou exigir um módulo que o Node.js ou o navegador não consegue localizar. Este erro pode ser causado por vários fatores, como erros de digitação no caminho do arquivo, problemas com o sistema de módulos, ou dependências não instaladas.
Um exemplo clássico desse erro pode ser o seguinte:
// main.js
const myModule = require('./myModule'); // Uncaught Error: Cannot find module './myModule'
No código acima, a tentativa de importar myModule
falha, provavelmente porque o caminho do arquivo está errado ou o arquivo não está presente no local especificado.
Como corrigir?
A primeira coisa a verificar é o caminho do arquivo. Verifique se o caminho está correto e se o arquivo realmente existe no local especificado. Além disso, se você estiver usando pacotes de terceiros, certifique-se de que todas as dependências foram corretamente instaladas usando o npm ou yarn.
Uma outra possibilidade é que, ao usar módulos do Node.js, o require()
possa estar sendo chamado de maneira incorreta. Aqui está um exemplo de como corrigir isso:
// Certifique-se de que o caminho esteja correto
const myModule = require('./myModule.js');
Ao garantir que os caminhos e as dependências estão corretamente configuradas, esse erro pode ser resolvido.
Como evitar o erro Uncaught Error: Cannot find module em JavaScript
Esse erro pode ser frustrante, especialmente quando você não sabe de onde ele vem. A chave para evitá-lo é garantir que você tenha configurado corretamente todos os caminhos e que todas as dependências estejam instaladas e presentes no seu projeto. Use ferramentas como o npm ls
para verificar se todas as dependências foram instaladas corretamente.
Algumas aplicações:
- Verificar os caminhos de importação de módulos.
- Usar gerenciadores de pacotes como npm ou yarn para garantir que todas as dependências sejam corretamente instaladas.
- Certificar-se de que o nome do módulo ou arquivo esteja correto.
Dicas para quem está começando
- Se você está usando
require
, lembre-se de adicionar a extensão do arquivo se necessário, como.js
. - Se estiver usando módulos do Node.js, certifique-se de que o arquivo que você está tentando importar está na mesma pasta ou no caminho correto.
- Se o erro acontecer ao usar pacotes de terceiros, tente rodar
npm install
ouyarn install
para garantir que todas as dependências estejam presentes.

Ricardo Vasconcellos
Desenvolvedor full stack especialista em PHP, JavaScript, Node.js, Python e SQL.
Mais sobre o autor