Go 中处理 HTTP 响应需先检查状态码(如 http.StatusOK 或

在 Go 中处理 HTTP 响应,核心是正确发起请求、检查状态码、读取响应体,并根据内容类型(如 JSON、纯文本、HTML)安全解析数据。关键不是“拿到数据”,而是“拿得稳、解得对、错得明”。
检查状态码再读取响应体
很多新手直接 resp.Body.Read(),却忽略 4xx/5xx 状态码——此时服务端可能返回错误描述,但程序仍当成功处理。务必先判断 resp.StatusCode:
- 用
http.StatusOK(即 200)或resp.StatusCode 判断逻辑成功 - 非成功状态建议显式返回错误,例如:
return fmt.Errorf("HTTP %d: %s", resp.StatusCode, resp.Status) - 注意:即使状态码是 200,响应体也可能为空或格式异常,状态码只是第一道关卡
及时关闭 Body 防止连接泄漏
resp.Body 是一个 io.ReadCloser,不关闭会导致底层 TCP 连接无法复用,高并发下容易耗尽连接池。
- 用
defer resp.Body.Close()是最简方式,但需确保它在函数退出前执行(尤其在 error 分支里也要 close) - 更稳妥写法:
if resp != nil && resp.Body != nil { defer resp.Body.Close() } - 如果后续要用
ioutil.ReadAll或io.ReadAll(Go 1.16+),记得它不自动关闭 body,仍需手动 close
按 Content-Type 解析响应数据
响应头中的 Content-Type 决定了你该用什么方式解包。别硬猜,先看 header:
立即学习“go语言免费学习笔记(深入)”;
- JSON(
application/json):用json.Unmarshal(bodyBytes, &v),结构体字段加json:"field_name"标签 - 表单数据(
application/x-www-form-urlencoded):用url.ParseQuery(string(bodyBytes)) - 纯文本(
text/plain):直接转字符串string(bodyBytes) - HTML/XML:推荐用
golang.org/x/net/html解析,避免正则提取(不可靠且易崩)
处理常见陷阱:编码、超时与空响应
真实接口常有隐藏坑,提前兜住能少 debug 半天:
-
字符编码:HTTP 响应可能声明
charset=utf-8,但 body 实际含 BOM 或 GBK。建议统一用golang.org/x/text/encoding检测并转换 -
超时控制:用
http.Client{Timeout: 10 * time.Second},别依赖默认值(可能长达 30 秒) -
空响应体:
io.ReadAll返回nil, nil表示空 body,不是错误,但你的业务逻辑可能需要特殊处理(比如返回默认值)
基本上就这些。Golang 的 HTTP 客户端设计克制而明确,不封装魔法,正因如此,每一步都要自己想清楚——状态码、body 生命周期、内容解析逻辑,三者环环相扣。写顺了,比写 Python requests 还踏实。










