INVALID_DEPENDENCY no deploy: como corrigir

O que significa esse erro

INVALID_DEPENDENCY significa que o arquivo de dependências está ausente ou vazio (0 bytes) na raiz do zip, então a Square Cloud não sabe quais pacotes instalar.

Por que acontece

• Causa mais comum: você compactou a pasta em vez do conteúdo dela. Abra o zip e confira se o package.json (ou requirements.txt) aparece direto na raiz.
• O arquivo de dependências simplesmente não está na raiz do projeto ou está vazio.
• O arquivo tem uma extensão a mais (ex.: package.json.txt em vez de package.json) — muitas vezes adicionada automaticamente pelo Windows ou por um editor de texto.

Como resolver

Node.js — garanta que exista um package.json na raiz:

• Se não existir, crie um com npm init -y.
• Confirme que o nome é exatamente package.json, sem extensão extra.

Python — garanta que exista um requirements.txt (ou pyproject.toml) na raiz, com o nome correto e as dependências listadas:

discord.py

Outros runtimes: Go usa go.mod ou go⁠.work; Rust Cargo.toml; Ruby Gemfile; Elixir mix.exs. Java, .NET, PHP e sites estáticos não exigem esse arquivo.

Confira a extensão. Ative "mostrar extensões de nome de arquivo" no seu sistema operacional e confirme que o arquivo é .json (Node) ou .txt (Python) — e não algo como package.json.txt.

Depois de corrigir, refaça o deploy da aplicação.

Relacionados

Se o arquivo for encontrado mas um pacote específico estiver faltando, veja MODULE_NOT_FOUND / Cannot find module: como resolver. Se a aplicação ainda não iniciar, revise Minha aplicação não inicia: Verificando o script de start.

Atualizado em: 04/10/2026