Corrigir erro 429 rate limit no Discord
O erro 429 aparece quando seu bot envia chamadas demais em pouco tempo. Com controle simples de fila e tempo de espera você reduz esse problema.
O que é erro 429
É uma proteção da API para manter estabilidade da plataforma. O bot precisa esperar e tentar novamente depois do tempo indicado.
Causas
- Loop enviando mensagem repetida sem pausa.
- Comando popular sem controle de fila.
- Tentativa de edição em massa ao mesmo tempo.
- Retry imediato em erro de rede sem backoff.
Como resolver
- Ler e respeitar retry_after em todas as rotas críticas.
- Agrupar mensagens quando possível.
- Criar fila para comandos de alto volume.
- Aplicar backoff progressivo em erro repetido.
Operação estável depende de monitoramento e deploy correto. Para isso, veja deploy com PM2 e hospedagem 24 horas para bot.
Evite soluções que apenas aumentam número de tentativas por segundo. Isso piora o problema e pode gerar bloqueios mais longos.
Perguntas frequentes
- 429 significa ban definitivo?
- Não. Normalmente é bloqueio temporário por excesso de chamadas.
- Reiniciar bot resolve sempre?
- Não. Se a lógica continuar igual, o erro volta rapidamente.
- Biblioteca oficial já trata rate limit?
- Muitas bibliotecas ajudam, mas sua lógica de negócio também precisa respeitar limites.
Próximo passo
Ver planos de bots
Bots Discord 24/7 com ativação rápida e suporte em português.
Guias relacionados
Hospedagem de bot Discord 24/7 no Brasil
Hospedagem bot Discord 24/7 combina process manager com restart automático, token fora do código, logs e servidor no Brasil para latência baixa com a API e seus jogadores.
Deploy de bot Discord Node.js com PM2: variáveis de ambiente e restart automático
PM2 é gerenciador de processos Node popular para bots Discord porque reinicia após crash, persiste entre reboots quando combinado com startup hook e centraliza logs mínimos sem montar Kubernetes inteiro. Este guia cobre arquivo ecosystem, env vars para token e integração com hospedagem BR.