正确处理Go中HTTP请求的错误与状态码:网络错误由error返回,需判空resp避免panic;非200状态码需显式检查StatusCode并读取Body;始终defer resp.Body.Close()防止泄漏。

在Go语言中处理HTTP请求时,错误处理和状态码解析是确保程序健壮性的关键环节。很多开发者容易忽略网络请求中的异常情况,导致程序在生产环境中出现不可预期的行为。本文将重点讲解如何正确处理HTTP请求中的错误,并合理解析响应状态码。
理解HTTP客户端错误类型
Go的net/http包在发起请求时可能返回多种错误,这些错误通常来自网络层或连接阶段:
- 网络连接失败:如DNS解析失败、超时、连接被拒绝等,这类错误会直接体现在http.Get或client.Do返回的error中
- TLS握手失败:当访问HTTPS接口时证书验证失败也会触发error
- 请求构建错误:比如URL格式不合法,在调用http.NewRequest时就可能出错
只要error不为nil,说明请求未成功发送或未收到响应,此时response对象通常为nil,不能直接读取Body或StatusCode。
正确处理非200状态码
即使HTTP请求成功发出并收到响应,服务器也可能返回非200状态码(如404、500)。需要注意的是,这些情况不会导致client.Do返回error,response对象依然有效。
立即学习“go语言免费学习笔记(深入)”;
必须显式检查resp.StatusCode来判断业务层面是否成功:
if resp.StatusCode != 200 {log.Printf("收到错误状态码: %d", resp.StatusCode)
// 可选择读取Body获取错误详情
body, _ := io.ReadAll(resp.Body)
log.Printf("响应内容: %s", string(body))
return fmt.Errorf("请求失败,状态码: %d", resp.StatusCode)
}
资源清理与延迟关闭
无论请求是否成功,只要resp不为nil,就必须关闭resp.Body以避免内存泄漏:
- 使用defer resp.Body.Close()确保资源释放
- 即使status code异常,也要先读取Body再关闭(尤其当服务端返回错误信息时)
- 在error != nil的情况下resp可能为nil,需先判空再关闭
典型写法:
resp, err := client.Do(req)if err != nil {
return err
}
defer resp.Body.Close()
常见状态码处理建议
针对不同状态码可采取差异化处理策略:
- 4xx客户端错误:检查请求参数、认证信息是否正确,通常是调用方问题
- 5xx服务端错误:可考虑重试机制,尤其是503临时不可用等情况
- 3xx重定向:默认情况下http.Client会自动跟随,可通过设置Client.CheckRedirect控制行为
可根据实际业务封装通用的响应处理器,统一处理日志、重试、熔断等逻辑。
基本上就这些。掌握错误与状态码的区分处理,能显著提升Go服务的稳定性。关键是不要把网络错误和HTTP语义错误混为一谈。










