> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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`:**

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

**Python — `requirements.txt`:**

```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](https://help.squarecloud.app/pt-br/article/invaliddependency-arquivo-de-dependencias-nao-encontrado-no-deploy-jgo2pm/). Para módulos nativos como o SQLite, veja [Could not locate the bindings file: como corrigir o erro do better-sqlite3](https://help.squarecloud.app/pt-br/article/could-not-locate-the-bindings-file-como-corrigir-o-erro-do-better-sqlite3-eclyf8/).