0Pricing
Go Academy · Aula

Tratamento de errors e lógica de novas tentativas

Verifique códigos de status e implemente novas tentativas

Tratamento de errors e lógica de novas tentativas é uma aula grátis de Go Academy no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Go Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Go Academy inclui 4 aulas no total.

Erros HTTP não são erros de Go

Um status HTTP 404 ou 500 não é um erro de Go — http.Client.Do retorna erro nil para qualquer resposta HTTP válida. Verifique resp.StatusCode explicitamente.

Encapsulamento de erros

Encapsule os erros com contexto usando fmt.Errorf("operation: %w", err) para que os chamadores possam inspecionar a causa com errors.Is / errors.As.

if err != nil {
    return fmt.Errorf("fetch users: %w", err)
}

Erros que permitem novas tentativas e erros que não permitem

Tente novamente em caso de: tempos limite de rede, 429 Muitas solicitações, 503 Serviço indisponível. Não tente novamente em caso de: 400 Solicitação inválida, 401 Não autorizado, 404 Não encontrado — tentar novamente não ajudará.

Espera exponencial

Aguarde mais tempo entre cada nova tentativa para reduzir a carga em um servidor sobrecarregado. Uma implementação simples:

for i := 0; i < maxRetries; i++ {
    resp, err := client.Do(req)
    if err == nil && resp.StatusCode < 500 { break }
    time.Sleep(time.Duration(math.Pow(2, float64(i))) * time.Second)
}

Variação aleatória

Adicione uma variação aleatória à espera para impedir que vários clientes tentem novamente ao mesmo tempo (avalanche de solicitações).

wait := time.Duration(math.Pow(2, float64(i)))*time.Second + time.Duration(rand.Intn(1000))*time.Millisecond

Cabeçalho Retry-After

A resposta 429 geralmente inclui um cabeçalho Retry-After. Analise-o e respeite-o em vez de usar uma espera fixa.

retryAfter := resp.Header.Get("Retry-After")
if secs, err := strconv.Atoi(retryAfter); err == nil {
    time.Sleep(time.Duration(secs) * time.Second)
}

Novas tentativas com suporte a contexto

Verifique o contexto antes de cada nova tentativa para parar de tentar se a solicitação tiver sido cancelada.

for i := 0; i < maxRetries; i++ {
    if ctx.Err() != nil { return nil, ctx.Err() }
    // attempt
}

Tipos de erro personalizados

Defina erros HTTP tipados para transportar o código de status e o corpo, permitindo que os chamadores tomem decisões detalhadas sobre novas tentativas.

type HTTPError struct {
    Status int
    Body   string
}
func (e *HTTPError) Error() string { return fmt.Sprintf("HTTP %d: %s", e.Status, e.Body) }

Opções de bibliotecas

Considere hashicorp/go-retryablehttp ou cenkalti/backoff para a lógica de novas tentativas em produção, com políticas de espera configuráveis, número máximo de novas tentativas e suporte a contexto.

Chaves de idempotência

Para solicitações POST que serão repetidas, inclua um cabeçalho de chave de idempotência (UUID) para que o servidor deduplicate as novas tentativas e retorne o mesmo resultado sem criar recursos duplicados.

Disjuntor

Um disjuntor acompanha as taxas de falha e deixa de enviar solicitações a um serviço com falhas durante um período de resfriamento. Bibliotecas como sony/gobreaker implementam esse padrão.

Verificação rápida

Por que você deve adicionar uma variação aleatória à espera exponencial?

Recapitulação: tratamento de erros e novas tentativas

Pontos principais:

  • Verifique resp.StatusCode — erros HTTP não são erros de Go
  • Tente novamente em caso de 429, 503 e tempos limite de rede; não em erros de cliente 4xx
  • Espera exponencial + variação aleatória evitam a avalanche de solicitações
  • Sempre verifique o contexto antes de tentar novamente

Perguntas Frequentes

A aula “Tratamento de errors e lógica de novas tentativas” é grátis?

Sim — o texto completo de “Tratamento de errors e lógica de novas tentativas” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Go Academy, atualize para CoddyKit PRO. O curso de Go Academy inclui 4 aulas no total.

O que vou aprender em “Tratamento de errors e lógica de novas tentativas”?

Verifique códigos de status e implemente novas tentativas Você pratica Go Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Go Academy?

Nenhuma experiência prévia é necessária. Go Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.

Quanto tempo leva a aula “Tratamento de errors e lógica de novas tentativas”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Go Academy?

Sim. Cada aula de Go Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

  1. Fazendo requisições HTTP
  2. Definindo timeouts e cabeçalhos
  3. Decodificando respostas JSON
  4. Tratamento de errors e lógica de novas tentativas
← Voltar para Go Academy