如何在Golang中处理HTTP响应_解析Status和Body内容

Go 中处理 HTTP 响应需正确读取 Status 和 Body,及时关闭 resp.Body 防连接泄漏,手动检查 StatusCode 而非依赖 Status,注意 resp 为 nil 的情况及超时设置。

在 Go 中处理 HTTP 响应,关键在于正确读取 http.ResponseStatus(状态行信息)和 Body(响应体),同时注意资源释放与错误处理。下面分几个实用角度说明。

获取响应状态码和状态文本

resp.StatusCode 是整数形式的 HTTP 状态码(如 200、404),resp.Status 是完整字符串(如 "200 OK")。一般推荐用 StatusCode 判断逻辑,更可靠:

  • 状态码用于条件分支(如 if resp.StatusCode == http.StatusOK
  • resp.Status 主要用于日志或调试,不建议用于判断——因某些服务可能返回非标准短语(如 "200 Success"
  • 注意:即使状态码是 4xx/5xx,http.DefaultClient.Do 默认不会返回 error;需手动检查

安全读取并关闭响应 Body

resp.Bodyio.ReadCloser,必须显式关闭,否则会泄漏连接(尤其在复用连接时):

  • defer resp.Body.Close() 是最常见做法,但要放在检查 err 之后,避免 panic
  • 若只读部分数据(如仅看前几个字节),仍需调用 Close(),否则连接无法复用
  • 如果后续要多次读取 Body(比如先解析 JSON 再保存原始内容),需用 io.ReadAll 一次性读完并缓存字节切片,再用 bytes.NewReader 重建可重读的 reader

解析 Body 内容(JSON / 文本 / 流式)

Body 是流式字节流,需根据 Content-Type 和业务需求选择解析方式:

  • JSON 响应:用 json.NewDecoder(resp.Body).Decode(&v),比 io.ReadAll + json.Unmarshal 更省内存
  • 纯文本:用 io.ReadAll(resp.Body) 得到 []byte,再转 string;注意字符编码(HTTP 默认为 UTF-8,但需检查 resp.Header.Get("Content-Type") 是否含 charset=
  • 大文件或流式处理:直接传 resp.Bodyio.Copy 或自定义 reader,边读边处理,避免全量加载

常见陷阱与建议

实际开发中容易忽略的细节:

  • 忘记检查 resp 是否为 nil(当 Do 返回 error 时,resp 可能为 nil)
  • 在 defer 中调用 resp.Body.Close() 前未判断 resp 是否非 nil
  • 对非 2xx 响应直接读 Body 而不先检查状态,导致业务逻辑误判成功
  • 未设置 http.Client.Timeout,请求卡住导致 goroutine 泄漏