正确处理Go网络请求错误需区分底层错误与HTTP状态码。首先检查http.Client.Do()返回的error是否为nil，若非nil则通过类型断言判断是否为net.Error、*url.Error等网络相关错误，并利用errors.Is()或errors.As()进行精确匹配；同时应使用context.WithTimeout设置超时，以触发context.DeadlineExceeded错误并避免请求挂起；即使error为nil，也需手动检查resp.StatusCode是否为4xx/5xx类错误，并读取响应体获取具体错误信息，从而全面保障程序健壮性。
在Go语言中进行网络请求时，错误处理是保证程序健壮性的关键环节。很多开发者在使用net/http包发起HTTP请求时，容易忽略某些隐藏的错误类型，导致程序在生产环境中出现不可预期的行为。本文将详细讲解Golang中如何正确捕获和处理网络请求中的各类错误。
理解HTTP请求中可能发生的错误类型
在调用http.Client.Do()方法发送请求时，返回值包含一个*http.Response和一个error。只有当error != nil时，才表示请求过程中发生了底层错误。
常见的错误类型包括：
- 连接失败：如DNS解析失败、TCP连接超时、服务器拒绝连接等
- TLS握手失败：HTTPS证书问题、不支持的协议版本等
- 网络中断：客户端或服务器网络不稳定
-
请求取消：通过
context.Context主动取消请求
需要注意的是，HTTP状态码为4xx或5xx并不会触发error，这些属于服务端响应，仍会返回*http.Response对象，需要手动检查resp.StatusCode来判断。
立即学习“go语言免费学习笔记（深入）”；
正确捕获和判断网络错误
使用类型断言可以进一步分析错误的具体原因。例如，可以通过net.Error接口判断是否为网络相关错误，并检查超时或临时性问题。
resp, err := http.Get("https://example.com")
if err != nil {
if netErr, ok := err.(net.Error); ok {
if netErr.Timeout() {
log.Println("请求超时:", netErr)
} else if netErr.Temporary() {
log.Println("临时性网络错误:", netErr)
} else {
log.Println("网络连接错误:", netErr)
}
} else if urlErr, ok := err.(*url.Error); ok {
log.Println("URL错误:", urlErr.Err)
} else {
log.Println("未知错误:", err)
}
return
}
defer resp.Body.Close()
对于更复杂的场景，还可以通过errors.Is()和errors.As()（Go 1.13+）进行错误比对和提取。
结合Context控制超时与取消
使用带超时的context是避免请求长时间挂起的有效方式。当请求超时时，Do()会返回context.DeadlineExceeded错误。
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
req, _ := http.NewRequestWithContext(ctx, "GET", "https://slow-site.com", nil)
resp, err := http.DefaultClient.Do(req)
if err != nil {
if errors.Is(err, context.DeadlineExceeded) {
log.Println("请求因超时被取消")
} else {
log.Println("请求失败:", err)
}
return
}
这种方式不仅能防止程序卡死，还能统一管理多个并发请求的生命周期。
处理HTTP响应状态码错误
即使err == nil，也必须检查resp.StatusCode，因为服务端可能返回404、500等错误状态码。
推荐做法是在读取响应体前先判断状态：
if resp.StatusCode < 200 || resp.StatusCode >= 300 {
body, _ := io.ReadAll(resp.Body)
log.Printf("HTTP %d: %s", resp.StatusCode, string(body))
return
}
对于JSON API，可封装通用的错误响应结构体，自动反序列化服务端返回的错误信息。
基本上就这些。掌握这些错误处理技巧，能显著提升Go程序在网络通信中的稳定性与可观测性。
