Problemas comuns
Os oito casos que respondem pela maioria dos chamados, com a causa e a correção de cada um.
A aplicação sobe e cai em seguida
Na quase totalidade dos casos, o processo terminou por um erro logo na inicialização. Abra a aba Logs: a última linha antes da parada diz o motivo. Os campeões são token ausente, dependência não declarada e erro de sintaxe.
O site sobe mas o endereço não abre
O código precisa escutar em 0.0.0.0 na porta 80. Escutar em localhost aceita conexões apenas de dentro do container, e escutar em outra porta faz o roteador não encontrar o processo.
// certo
app.listen(process.env.PORT || 80, "0.0.0.0");
// errado — não responde no domínio
app.listen(3000, "localhost");“Cannot find module” ou “ModuleNotFoundError”
A biblioteca não está no arquivo de dependências. Adicione-a ao `package.json` ou ao `requirements.txt` e publique de novo. Instalar na sua máquina não basta: o ambiente monta as dependências a partir desse arquivo.
A aplicação foi derrubada por falta de memória
O processo passou do limite da aplicação e foi encerrado. Duas saídas: aumentar a memória da aplicação (se o plano permitir) ou reduzir o consumo. As causas mais comuns são carregar arquivos grandes inteiros na memória, guardar cache sem limite e navegador headless sem fechar as abas.
O deploy falha dizendo que o pacote é grande demais
O limite por envio é de 100.0 MB, medido depois da limpeza automática. Se o seu pacote passa disso, procure por vídeos, áudios, imagens não otimizadas ou um banco de dados dentro do projeto.
Alterei uma variável e nada mudou
Variáveis são lidas quando o processo sobe. Reinicie a aplicação.
O bot conecta mas não responde a comandos
No Discord, quase sempre é intent faltando: ative Message Content Intent no portal do desenvolvedor e reinicie. Verifique também as permissões do bot no servidor.
Editei um arquivo e a aplicação não mudou
O arquivo foi gravado, mas o processo em execução continua com a versão antiga carregada. Reinicie.