Go Academy · 课时

错误处理与重试逻辑

Q: 「错误处理与重试逻辑」这节课中我会学到什么？

检查状态码并实现重试 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

检查状态码并实现重试

错误处理与重试逻辑 是 CoddyKit 上的免费 Go Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

HTTP 错误不是 Go 错误

HTTP 404 或 500 状态不是 Go 错误——对于任何有效的 HTTP 响应，http.Client.Do 都会返回 nil 错误。请显式检查 resp.StatusCode。

包装错误

使用 fmt.Errorf("operation: %w", err) 添加上下文来包装错误，以便调用方通过 errors.Is / errors.As 检查原因。

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

可重试与不可重试的错误

可以重试：网络超时、429 请求过多、503 服务不可用。不要重试：400 错误请求、401 未授权、404 未找到——重试不会有帮助。

指数退避

逐次重试之间等待更长时间，以减轻故障服务器的负载。一种简单的实现方式：

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)
}

抖动

在退避时间中加入随机抖动，防止多个客户端同时重试（惊群效应）。

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

Retry-After 标头

429 响应通常包含 Retry-After 标头。请解析并遵循它，而不是使用固定的退避时间。

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

支持上下文的重试

在每次重试前检查上下文，如果请求已被取消，就停止重试。

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

自定义错误类型

定义带类型的 HTTP 错误以携带状态码和正文，使调用方能够做出更细致的重试决定。

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

库选项

对于生产环境中的重试逻辑，可以考虑使用 hashicorp/go-retryablehttp 或 cenkalti/backoff，它们支持可配置的退避策略、最大重试次数和上下文。

幂等键

对于需要重试的 POST 请求，请在标头中加入幂等键（UUID），这样服务器就能对重试请求去重，并返回相同结果，而不会创建重复资源。

熔断器

熔断器会跟踪失败率，并在冷却期间停止向故障服务发送请求。sony/gobreaker 等库实现了这种模式。

快速检查

为什么应在指数退避中加入抖动？

回顾：错误处理与重试

要点：

检查 resp.StatusCode——HTTP 错误不是 Go 错误
对 429、503 和网络超时进行重试；不要对 4xx 客户端错误重试
指数退避加抖动可以防止惊群效应
重试前始终检查上下文

常见问题解答

「错误处理与重试逻辑」课时是免费的吗？

是的 — 「错误处理与重试逻辑」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「错误处理与重试逻辑」这节课中我会学到什么？

检查状态码并实现重试你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「错误处理与重试逻辑」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy