在使用 golang 发起 HTTP 客户端请求时，正确处理错误是确保程序健壮性的关键。Go 的 net/http 包本身不会对 HTTP 状态码（如 404 或 500）自动返回错误，因此开发者需要手动检查响应状态和连接层面的错误。
区分网络错误与HTTP状态错误
发起一个 HTTP 请求可能遇到两类主要错误：
- 网络层面错误：比如 dns 解析失败、连接超时、无法建立 TCP 连接等。这类错误会在调用 http.Get、client.Do 等方法时直接返回非 nil 的 Error。
- HTTP 状态错误：比如服务器返回 404 Not Found、500 internal Server Error。这些情况虽然有响应，但不代表成功。Go 不会把这些当作 error 抛出，需通过检查 resp.StatusCode 来判断。
示例代码：
resp, err := http.Get("https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca") if err != nil { // 处理网络错误，例如超时、DNS 失败 log.Printf("请求失败: %v", err) return } defer resp.Body.Close() <p>// 检查 HTTP 状态码 if resp.StatusCode != http.StatusOK { log.Printf("HTTP 错误: %d %s", resp.StatusCode, resp.Status) return }</p><p>// 正常处理响应体 body, _ := io.ReadAll(resp.Body) fmt.Println(string(body))
设置超时避免请求挂起
默认的 http.Client 可能会因网络问题长时间阻塞。建议始终设置合理的超时时间。
立即学习“go语言免费学习笔记（深入）”；
推荐创建自定义 client：
client := &http.Client{ Timeout: 10 * time.Second, } <p>resp, err := client.Get("<a href="https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca">https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca</a>") if err != nil { log.Printf("请求异常: %v", err) return } defer resp.Body.Close()
更精细的控制可以配置 Transport 层的 DialTimeout 和 TLSHandshakeTimeout，防止在连接或握手阶段卡住。
重试机制应对临时性错误
对于网络抖动或服务短暂不可用，可加入简单重试逻辑，特别适用于 5xx 错误或连接失败。
var resp *http.Response var err error for i := 0; i < 3; i++ { resp, err = client.Get("https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca") if err == nil && resp.StatusCode == http.StatusOK { break } time.Sleep(1 * time.Second) } if err != nil { log.Printf("最终请求失败: %v", err) return } if resp.StatusCode != http.StatusOK { log.Printf("最终状态码错误: %d", resp.StatusCode) return }
统一错误封装提升可读性
在实际项目中，可以把请求错误封装成自定义错误类型，便于上层处理和日志记录。
type HTTPError struct { StatusCode int URL string Message string } <p>func (e *HTTPError) Error() string { return fmt.Sprintf("HTTP %d from %s: %s", e.StatusCode, e.URL, e.Message) }
在请求后根据情况返回此类错误，有助于追踪问题来源。
基本上就这些。关键是分清错误类型，设置超时，检查状态码，并根据业务需要决定是否重试。Go 不隐藏细节，但也正因如此，你能更清楚地掌控每一次请求的行为。