Skip to content

troubleshooting

Jump to bottom
willianpm edited this page Feb 27, 2026 · 9 revisions

Troubleshooting

Soluções para problemas comuns do LittleBoatPoll.

Bot não conecta / Não fica online

Problema

Bot não aparece online no servidor Discord.

Causas Possíveis

  • Token inválido ou incorreto
  • Bot não foi convidado ao servidor
  • Intents não habilitados

Soluções

1. Verificar TOKEN no .env:

# Certifique-se que o token está correto
TOKEN=seu_token_aqui_sem_espacos

2. Verificar intents no Discord Developer Portal:

  1. Acesse Discord Developer Portal
  2. Selecione seu bot
  3. Vá em Bot
  4. Em Privileged Gateway Intents, ative:
    • Message Content Intent
    • Server Members Intent (opcional)
  5. Salve as mudanças

3. Reinvitar o bot:

  1. Gere nova URL de convite em OAuth2 → URL Generator
  2. Selecione bot e applications.commands
  3. Adicione permissões necessárias
  4. Use a URL para convidar ao servidor

Comandos não aparecem no Discord

Problema

Ao digitar /, os comandos do bot não aparecem.

Causas Possíveis

  • Comandos não foram registrados
  • Discord ainda não sincronizou
  • Bot sem permissão de slash commands

Soluções

1. Registrar/Re-registrar comandos:

npm run deploy

Aguarde a mensagem de sucesso:

✅ Todos os comandos registrados com sucesso!

** 2. Aguardar sincronização:**

  • Discord pode levar até 1 hora para sincronizar
  • Em servidores grandes, pode demorar mais
  • Geralmente leva 5-10 minutos

3. Verificar permissões do bot: No convite, certifique-se de que applications.commands está selecionado.

4. Tentar comando global:

  • Envie mensagem direta ao bot (se DM habilitado)
  • Comandos devem aparecer em DM instantaneamente

5. Forçar atualização (último recurso):

# Remova o bot do servidor
# Re-convide com URL atualizada
# Execute npm run deploy novamente

❌ Erro: "Unknown interaction" (10062)

Problema

DiscordAPIError[10062]: Unknown interaction

Causa

Bot demorou mais de 3 segundos para responder.

Solução

✅ Já corrigido na v1.2!

Se ainda ocorrer:

  1. Verifique conexão com internet
  2. Confirme que servidor Discord está estável
  3. Bot pode estar sobrecarregado (muitas requisições simultâneas)

🔴 Reações não funcionam / Não aparecem

Problema

Enquete criada mas sem reações, ou bot não consegue adicionar reações.

Causas Possíveis

  • Bot sem permissão "Add Reactions"
  • Canal bloqueado para external emojis
  • Mais de 20 opções (limite do Discord)

Soluções

1. Verificar permissões do bot no canal:

Permissões necessárias:

  • Send Messages
  • Embed Links
  • Add Reactions
  • Read Message History

2. Limitar opções:

Máximo: 20 opções por enquete

3. Verificar configurações do canal:

  • Canal não deve bloquear reações externas
  • Bot deve ter acesso de leitura/escrita

📝 Rascunhos não salvam / Desaparecem

Problema

Rascunhos criados mas desaparecem ao reiniciar bot.

Causa

  • ❌ Arquivo draft-polls.json corrompido
  • ❌ Permissões de escrita no diretório
  • ❌ Bot não tem acesso ao arquivo

Soluções

1. Verificar se arquivo existe:

ls -la draft-polls.json
# ou no Windows:
dir draft-polls.json

2. Verificar conteúdo:

cat draft-polls.json
# ou no Windows:
type draft-polls.json

Deve ser um JSON válido: [] ou [{...}]

3. Recriar arquivo (se corrompido):

echo [] > draft-polls.json

4. Verificar permissões:

# Linux/Mac
chmod 644 draft-polls.json

# Windows: Propriedades → Segurança → Editar

Votos não contam / Peso errado

Problema

Votos parecem não ser contados ou peso de mensalistas não funciona.

Causas Possíveis

  • Mensalista não adicionado corretamente
  • mensalistas.json corrompido
  • Múltiplos votos ultrapassando limite

Soluções

1. Entender o sistema de peso:

Veja Sistema de Peso Mensalista para compreender como o peso funciona.

2. Verificar lista de mensalistas:

/mensalista listar

3. Re-adicionar mensalista:

/mensalista remover usuario:@Usuario
/mensalista adicionar usuario:@Usuario

4. Verificar max_votos:

  • Usuário pode ter votado no limite máximo
  • Remova um voto existente para votar em outro

5. Encerrar e verificar resultados:

Use Encerrar Votação para ver cálculo detalhado.

🚫 Erro de Permissão ao criar enquete

Problema

❌ Permissão negada! Apenas Criadores de Enquetes, Administradores ou o dono do servidor podem executar este comando.

Causa

Usuário não possui permissão de Criador de Enquetes.

Soluções

1. Adicionar como Criador de Enquetes:

/criador adicionar usuario:@Usuario

2. Verificar lista de criadores:

/criador listar

3. Usar Context Menu (alternativa rápida):

  1. Clique direito no usuário
  2. Apps → "Add/Del Criador de Enquetes"

4. Verificar se é Administrador:

  • Certifique-se que o usuário tem permissão de Administrador no Discord
  • Administradores têm acesso automático

5. Registrar manualmente (avançado):

Edite criadores-internos.json:

{
  "criadores": ["ID_DO_USUARIO_AQUI"]
}

⚠️ Nota: O arquivo cargos-criadores.json não é mais usado desde a versão 2.0.0

Arquivos JSON corrompidos

Problema

Erro ao carregar dados, arquivos JSON inválidos.

Sintomas

SyntaxError: Unexpected token...

Solução

Backup primeiro:

cp active-polls.json active-polls.json.backup

Recriar arquivos:

# Linux/Mac/Git Bash
echo '[]' > draft-polls.json
echo '[]' > active-polls.json
echo '{"votacoes": []}' > historico-votacoes.json
echo '{"mensalistas": []}' > mensalistas.json
echo '{"cargos": []}' > cargos-criadores.json
echo '{}' > votos.json
# PowerShell (Windows)
'[]' | Out-File -Encoding UTF8 draft-polls.json
'[]' | Out-File -Encoding UTF8 active-polls.json
'{"votacoes": []}' | Out-File -Encoding UTF8 historico-votacoes.json
'{"mensalistas": []}' | Out-File -Encoding UTF8 mensalistas.json
'{"cargos": []}' | Out-File -Encoding UTF8 cargos-criadores.json
'{}' | Out-File -Encoding UTF8 votos.json

⚠️ Atenção: Isso apaga todos os dados existentes!

Bot travando / Não responde

Problema

Bot para de responder após algum tempo.

Causas Possíveis

  • Memória insuficiente
  • Erro não tratado
  • Loop infinito

Soluções

1. Verificar logs:

npm start
# Observe a saída do console

2. Reiniciar bot:

# Ctrl+C para parar
npm start

3. Verificar memória:

# Linux/Mac
free -h

# Windows (Task Manager)
taskmgr

4. Limpar arquivos temporários:

rm -rf node_modules
npm install

📦 Erro ao instalar dependências

Problema

npm ERR! code ENOENT

Soluções

1. Verificar versão do Node.js:

node --version
# Deve ser 18.0+ ou superior

2. Limpar cache do npm:

npm cache clean --force
npm install

3. Deletar e reinstalar:

rm -rf node_modules package-lock.json
npm install

4. Usar yarn (alternativa):

npm install -g yarn
yarn install
yarn start

🌐 Erro de Keep-Alive / Porta em uso

Problema

Error: listen EADDRINUSE: address already in use :::8000

Causa

Porta 8000 já está em uso por outro processo.

Soluções

1. Encontrar e matar processo:

# Linux/Mac
lsof -i :8000
kill -9 [PID]

# Windows
netstat -ano | findstr :8000
taskkill /PID [PID] /F

2. Mudar porta no código: Edite index.js, procure por 8000 e mude para outra porta (ex: 8001).

🔑 TOKEN exposto acidentalmente

Problema

Você commitou o .env no Git ou compartilhou o TOKEN.

⚠️ AÇÃO URGENTE

1. Regenerar TOKEN imediatamente:

  1. Acesse Discord Developer Portal
  2. Vá em Bot
  3. Clique em "Reset Token"
  4. Copie o novo token
  5. Atualize o .env

2. Remover do Git (se commitado):

git rm --cached .env
git commit -m "Remove .env"
git push

3. Verificar .gitignore:

.env
node_modules/
*.log

📞 Ainda com Problemas?

Se nenhuma solução funcionou:

  1. Verifique os logs completos:

    npm start > logs.txt 2>&1

  2. Teste em ambiente limpo:

    • Clone o repositório em nova pasta
    • Configure do zero
    • Teste com servidor Discord novo

  3. Recursos úteis:

← Voltar para Comandos | Próximo: Changelog →

Clone this wiki locally