Golang发送GET与POST请求教程

本文深入剖析了Go语言中HTTP请求的正确实践，指出虽可直接使用http.Get和http.Post，但因其依赖无超时机制的默认客户端，极易引发请求阻塞、goroutine泄漏及连接池耗尽等生产级风险；文章强调必须显式创建带Timeout（推荐5–10秒）的http.Client，GET请求应通过url.Values安全拼接并自动编码参数，POST发送JSON时需先json.Marshal再用bytes.NewReader包装，并手动设置Content-Type头，同时务必在所有路径（包括错误处理）中defer resp.Body.Close()以防止连接泄漏——这些看似细节的规范，实则是保障服务稳定、可维护与高性能的关键所在。

Go 的 http.Get 和 http.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 容易出编码/转义问题。

示例关键片段：

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.Reader（bytes.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.ReadAll 再 json.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）。

终于介绍完啦！小伙伴们，这篇关于《Golang发送GET与POST请求教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！