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

Adicione a biblioteca que falta ao seu arquivo de dependências e reinicie a aplicação para que tudo seja reinstalado.

Node.js — package.json:

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

Python — requirements.txt:

discord.py

Depois de atualizar o arquivo, reinicie (ou refaça o deploy) da aplicação. A plataforma lê o arquivo de dependências e instala os pacotes listados.

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: 13/06/2026