正确处理Golang网络请求错误需先判断error是否为nil，再检查状态码。常见错误包括连接失败、超时、TLS握手失败等，均通过error返回而非HTTP状态码。应使用errors.As()对*url.Error进行类型断言，区分超时与普通连接错误，并设置合理超时避免阻塞。只有err为nil时才可安全读取响应体并校验状态码，确保程序健壮性。
在 Golang 中进行网络请求时，错误处理是保证程序健壮性的关键环节。很多开发者初上手时常忽略或误判错误类型，导致程序在遇到网络异常、超时或服务不可达时崩溃或行为不可控。正确捕获和处理这些错误，不仅能提升稳定性，还能为后续排查问题提供依据。
理解 net/http 中的常见错误类型
使用 net/http 包发起请求时，错误通常来自 http.Client.Do() 方法返回的第二个参数 error。这个 error 可能包含多种底层问题：
- 连接失败：目标主机无法访问、DNS 解析失败
- 超时：请求耗时超过设定时限
- TLS 握手失败：证书问题、不支持的协议版本
- 空响应：服务器未返回有效 response（resp 为 nil）
这些错误不会以 HTTP 状态码形式出现（如 404、500），而是直接通过 error 返回。因此不能只检查 status code，必须先判断 error 是否为 nil。
正确捕获并分类处理错误
实际开发中应根据错误类型采取不同策略，例如重试、记录日志或向上抛出。可以通过类型断言判断是否为 *url.Error，它封装了底层错误详情：
立即学习“go语言免费学习笔记（深入）”；
resp, err := http.Get("https://httpbin.org/delay/5")
if err != nil {
var urlErr *url.Error
if errors.As(err, &urlErr) {
if urlErr.Timeout() {
log.Println("请求超时:", urlErr)
} else {
log.Println("连接错误:", urlErr.Err)
}
} else {
log.Println("未知错误:", err)
}
return
}
defer resp.Body.Close()
这里用 errors.As() 替代旧式类型断言，更安全且兼容包装错误。如果知道具体场景，还可以进一步判断是否为 DNS 错误或 TLS 错误。
设置合理的超时避免永久阻塞
默认的 http.Client 没有超时设置，可能导致请求长时间挂起。生产环境务必配置超时：
client := &http.Client{
Timeout: 10 * time.Second,
}
resp, err := client.Get("https://example.com")
也可以精细控制各阶段超时：
client := &http.Client{
Transport: &http.Transport{
DialContext: (&net.Dialer{
Timeout: 5 * time.Second,
KeepAlive: 30 * time.Second,
}).DialContext,
TLSHandshakeTimeout: 5 * time.Second,
ResponseHeaderTimeout: 10 * time.Second,
ExpectContinueTimeout: 1 * time.Second,
},
Timeout: 30 * time.Second,
}
这样可以更精准地识别是连接阶段还是读取阶段出错。
结合状态码与网络错误综合判断
即使请求成功（err == nil），也可能返回非 2xx 状态码。需同时检查：
if resp.StatusCode >= 400 {
body, _ := io.ReadAll(resp.Body)
log.Printf("业务错误 %d: %s", resp.StatusCode, string(body))
}
注意：只有在网络层无错误的前提下才能读取 Body。否则 resp 可能为 nil，直接调用会 panic。
基本上就这些。Golang 的错误处理虽显繁琐，但清晰明确。只要养成“先判 error，再读响应”的习惯，并合理设置超时，就能有效应对大多数网络异常。
