Golang如何进行HTTP客户端请求_Golang net/http发送GET与POST请求

11次阅读

gohttp.Get 和 http.Post 不推荐在生产环境直接使用,因依赖无超时设置的 http.DefaultClient,易导致请求阻塞和 goroutine 泄漏;应显式创建带 Timeout 的 http.Client,并用 url.Values 拼接 GET 参数、bytes.NewReader 包装 json.Marshal 结果发送 POST,且必须 defer resp.Body.Close()。

Golang如何进行HTTP客户端请求_Golang net/http发送GET与POST请求

Go 的 http.Gethttp.Post 能直接用吗?

能,但不推荐在生产环境直接用。它们是快捷封装,内部都调用 http.DefaultClient,而这个默认客户端没有设置超时,一旦后端卡住或网络异常,请求会无限阻塞(常见于容器内 dns 解析失败、服务未启动等场景)。你看到的程序“卡死”或 goroutine 泄漏,往往就源于此。

实操建议:

  • 永远显式创建 http.Client,并设置 Timeout(推荐 5–10 秒)
  • http.Get(url) 等价于 http.DefaultClient.Get(url),本质没区别
  • http.Post(url, contentType, body) 会自动设置 Content-Type 头,但无法自定义其他 header,也不支持 json 自动序列化

发送带 JSON 的 POST 请求该用 json.Marshal 还是 bytes.NewReader

两者都要用:先 json.Marshal 序列化结构体,再用 bytes.NewReader 包装成 io.Reader 传给 http.NewRequest。直接拼接字符串或用 Strings.NewReader 容易出编码/转义问题。

示例关键片段:

立即学习go语言免费学习笔记(深入)”;

data := map[string]interface{}{"name": "Alice", "age": 30} body, _ := json.Marshal(data) req, _ := http.NewRequest("POST", "https://api.example.com/users", bytes.NewReader(body)) req.Header.Set("Content-Type", "application/json") client := &http.Client{Timeout: 8 * time.Second} resp, err := client.Do(req)

注意点:

  • 别漏掉 req.Header.Set("Content-Type", "application/json"),否则服务端可能解析失败
  • json.Marshal 返回 []byte,必须转成 io.Readerbytes.NewReader 最轻量)
  • 如果要复用连接,记得在 http.Client 中配置 Transport,否则默认每请求新建 TCP 连接

GET 请求带参数,用 url.Values 拼还是手动写 query string?

url.Values。手动拼接容易忽略 URL 编码(比如空格变 +、中文变 %E4%BD%A0),导致服务端收不到参数或 400 错误。

正确做法:

params := url.Values{} params.Set("q", "go http client") params.Set("page", "1") u, _ := url.Parse("https://api.example.com/search") u.RawQuery = params.Encode() resp, _ := http.DefaultClient.Get(u.String())

常见坑:

  • url.Values.Encode() 返回已编码字符串,不要二次 url.QueryEscape
  • 如果 URL 已含 query(如 ?v=1),要用 u.RawQuery = old + "&" + params.Encode() 合并,不能直接覆盖
  • 某些 API 要求参数顺序固定(如签名计算),url.Values 是 map,遍历时顺序不确定;此时需手写有序 slice + url.Values.Add

为什么 resp.Body 必须 Close,且不能只读一次?

因为 resp.Body 是底层 TCP 连接的读取流,不 Close 会导致连接无法释放,HTTP/1.1 连接池耗尽后后续请求全部 hang 住;而多次读(如先 ioutil.ReadAlljson.Unmarshal)会失败——Body 是单次读取流,第二次读返回空。

安全写法:

  • defer resp.Body.Close() 确保关闭(哪怕中间 panic)
  • 读取后立刻处理,不要反复读 Body;需要多次使用内容时,先 bodyBytes, _ := io.ReadAll(resp.Body),再用 bytes.NewReader(bodyBytes) 构造新 reader
  • 若用 json.NewDecoder(resp.Body).Decode(&v),它内部会读完流,之后不能再读 Body

最常被忽略的是:错误路径下忘记 Close。务必在 if err != nil 后也加 resp.Body.Close()(或统一 defer,但要确保 resp 非 nil)。

text=ZqhQzanResources