在golang中处理http请求错误，需先判断底层错误再检查响应状态码。1. 底层错误如dns解析失败、连接超时等由http.get()或http.do()返回的error体现，必须通过if err != nil处理；2. 服务器返回非2xx状态码如404、500需手动检查resp.statuscode；3. 读取响应体错误如连接中断需在io.readall时处理；4. 客户端配置错误如非法header也应通过error处理。此外，应始终关闭resp.body，推荐使用defer resp.body.close()，并可封装工具函数统一处理错误，区分可重试与不可重试错误，记录详细错误信息以便排查问题。示例代码展示了如何分类处理各类错误并包装原始错误供后续分析。
在Golang中处理HTTP请求错误，核心在于理解
net/http包的错误传播机制以及常见的错误类型。Go的标准库并没有提供统一的错误处理框架，而是鼓励开发者通过显式判断和组合逻辑来处理各种异常情况。
HTTP请求中的常见错误类型
在使用
net/http发送HTTP请求时，可能会遇到多种错误，主要包括以下几种：
- 网络连接错误：比如DNS解析失败、TCP连接超时、无法建立TLS连接等。
- 服务器返回非2xx状态码：比如404 Not Found、500 Internal Server Error等。
- 读取响应体出错：比如连接被服务器关闭、读取超时等。
- 客户端配置错误：比如设置了非法的Header、请求方法不支持等。
这些错误通常由
http.Client.Do()或
http.Get()等函数返回的
error对象体现，但并不是所有HTTP“错误”都会体现在这个
error里。比如，如果服务器返回了404，
error是
nil，你需要手动检查响应状态码。
立即学习“go语言免费学习笔记（深入）”；
如何正确判断并处理错误
当你调用
http.Do(req)或者类似的方法时，只有在请求完全无法完成的情况下才会返回一个非
nil的
error。例如：
resp, err := http.Get("https://example.com")
if err != nil {
// 这里处理的是连接失败、证书问题等底层错误
}而像404、500这类错误，必须手动检查
resp.StatusCode：
if resp.StatusCode >= 400 {
// 处理业务层面的错误
}所以，完整的错误处理结构应该包括两个部分：
- 判断底层错误（
err != nil
） - 检查响应状态码是否为成功状态（如200~299）
你也可以结合
io.ReadAll(resp.Body)时可能出现的错误一起处理，比如读取过程中连接中断。
实用建议与注意事项
常见做法
-
始终先检查error变量：不要跳过对
err != nil
的判断，否则可能导致访问resp
时出现panic。 -
及时关闭resp.Body：即使出错了，也要记得关闭
resp.Body
以释放资源，推荐使用defer resp.Body.Close()
。 - 封装错误处理逻辑：如果你的应用需要频繁发起HTTP请求，可以封装一个工具函数来统一处理错误和状态码。
- 区分可重试与不可重试错误：比如网络波动导致的错误可以考虑重试，而404则不需要。
- 记录错误详情：对于生产环境的服务，建议将错误信息记录下来，包括URL、状态码、具体错误内容等，便于排查问题。
示例代码片段
func fetch(url string) ([]byte, error) {
resp, err := http.Get(url)
if err != nil {
return nil, fmt.Errorf("http get error: %w", err)
}
defer resp.Body.Close()
if resp.StatusCode < 200 || resp.StatusCode >= 300 {
return nil, fmt.Errorf("unexpected status code: %d", resp.StatusCode)
}
body, err := io.ReadAll(resp.Body)
if err != nil {
return nil, fmt.Errorf("read response body error: %w", err)
}
return body, nil
}这个例子展示了如何将不同类型的错误分类处理，并用
%w包装原始错误以便后续分析。
基本上就这些。只要掌握这两类错误的区别和处理方式，就能在大多数场景下写出健壮的HTTP客户端代码。
