Pular para o conteúdo principal

Guia de Resolução de Problemas (Troubleshooting)

Resolva erros do seu bot em segundos com o nosso guia prático de soluções! 🚀🦾🩹✨🦾🔧✨🏆

1. Meu bot não inicia (Status "Error" ou "Stopped") 🕵️‍♂️✨​

Sintoma: O status no painel está em ERROR ou o bot cai logo após o deploy.

  • Causa A: Erro no script start em seu package.json.
    • Solução: Verifique se as dependências estão no lugar e se o seu comando no package.json aponta para o arquivo certo (ex: "start": "node index.js").
  • Causa B: Pacote não listado como dependência.
    • Solução: Se o seu código usa require('axios'), você DEVE ter axios na seção "dependencies" do seu package.json. 📦
  • Causa C: Erro de Sintaxe (SyntaxError). 📡
    • Solução: Abra os Logs do bot e procure pela linha do erro. Teste seu código localmente antes de subir. 🚀

2. O Deploy parou em "INSTALLING" 📡⚡️🦾​

Sintoma: O bot já está "instalando" dependências há mais de 5 minutos.

  • Causa: Instalação do npm travada ou lenta.
    • Solução: Tente fazer um Novo Deploy manual via painel. Se não resolver, verifique se não há pacotes gigantes ou perigosos no seu package.json. 🗑️

3. Bot Online no Painel, mas Offline no Discord 🧐​

Sintoma: O status está Running, mas o bot não responde comandos.

  • Causa A: Token inválido. 🔐
    • Solução: Verifique se o seu DISCORD_TOKEN nas Env Vars está correto e sem aspas extras ao redor. 🛡️
  • Causa B: Intents Desativados. 📡
    • Solução: Vá no Discord Developer Portal, selecione seu bot > Bot > e ative Privileged Gateway Intents (Presence e Message Content). 🛡️✨🏆

4. Erro de Memória (Memory Limit Exceeded) 🧠🗑️​

Sintoma: O bot cai aleatoriamente com a mensagem de OOM (Out Of Memory).

  • Causa: Seu bot está tentando usar mais RAM do que o seu plano permite (ex: > 256MB).
    • Solução:
      1. Otimize os seus caches de membros/mensagens no código.
      2. Considere o Upgrade de Plano se o seu bot for grande (mais de 1.000 servidores). 🛡️✨🏆

5. Erro com Módulos Espefíficos (Sqlite, Canvas) 📦🔧✨​

  • Causa: Algumas bibliotecas precisam de pacotes do sistema linux (libgl, libxi, etc).
    • Solução: Use bibliotecas compatíveis com ambientes puros de Node.js (ex: better-sqlite3 costuma funcionar melhor). Se for essencial, entre em contato com o suporte para habilitarmos o driver no seu container. 🛡️✨🏆

💡 Dica de Ouro 🎉​

Sempre que você mudar qualquer coisa no package.json ou nas Variáveis de Ambiente, você DEVE clicar em Fazer Novo Deploy 🚀 para que o sistema atualize o seu bot com as novas configurações! 🛡️✨🏆

💡 Próxima etapa: Perguntas Frequentes (FAQ). 🦾⚡️🦾