MODULE_NOT_FOUND / Cannot find module: como resolver

O que significa esse erro

Sua aplicação está tentando usar uma biblioteca que não está instalada no ambiente. Dependendo da linguagem, a mensagem aparece assim:

# JavaScript / Node.js
Error: Cannot find module 'discord.js'

# Python
ModuleNotFoundError: No module named 'discord'

Por que acontece

Na Square Cloud, as bibliotecas não são instaladas por padrão — elas precisam estar declaradas no seu arquivo de dependências para que a plataforma as instale durante o deploy. Se um pacote estiver faltando nesse arquivo (ou foi instalado apenas localmente no seu computador), a aplicação não o encontra em tempo de execução.

Como resolver

Node.js: depois de editar o package.json, apague a pasta node_modules (e o package-lock.json, se você enviou um) no gerenciador de arquivos do dashboard e reinicie. Sem a node_modules, a próxima inicialização roda o npm install. Python: basta reiniciar, porque as dependências são instaladas a cada inicialização.

Node.js — package.json:

{
  "dependencies": {
    "discord.js": "14.14.1"
  }
}

Python — requirements.txt:

discord.py

Depois de atualizar o arquivo, reinicie a aplicação. A plataforma instala as dependências na inicialização quando a pasta node_modules não existe (Node.js) ou a cada inicialização (Python). No Node.js, apague a node_modules antes de reiniciar.

Checklist rápido

• A biblioteca está escrita exatamente como publicada no npm/PyPI?
• Ela está listada em dependencies (e não só em devDependencies)?
• Você reiniciou a aplicação depois de editar o arquivo?

Relacionados

Se o próprio arquivo de dependências não for encontrado, veja INVALID_DEPENDENCY: arquivo de dependências não encontrado no deploy. Para módulos nativos como o SQLite, veja Could not locate the bindings file: como corrigir o erro do better-sqlite3.

Atualizado em: 04/10/2026