Go 的 http.Get 和 http.Post 不推荐在生产环境直接使用,因依赖无超时设置的 http.DefaultClient,易导致请求阻塞和 goroutine 泄漏;应显式创建带 Timeout 的 http.Client,并用 url.Values 拼接 GET 参数、bytes.NewReader 包装 json.Marshal 结果发送 POST,且必须 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 容易出编码/转义问题。
示例关键片段:
立即学习“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.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)。










