在 Go 语言中,我们可以使用标准库 net/http 包让程序作为客户端(HTTP Client)向外部服务器发送网络请求,比如调用天气查询接口、支付接口或大模型接口获取数据。
根据实际需求的不同,发送 HTTP 请求常用的有以下 3 种方式:使用 http.Get() 读取数据、使用 http.Post() 提交数据,以及通过 http.Client 配合 http.NewRequest() 自定义请求头和超时时间。
发送 GET 请求:http.Get()
当我们只需要从某个网址或接口读取数据时,最常用的就是发送 GET 请求。在 net/http 包中,我们可以直接调用 http.Get() 函数来实现。
语法:
resp, err := http.Get(请求网址)
if err != nil {
// 处理请求错误
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)说明:
返回值 resp 是英文 “response(响应)” 的缩写,代表服务器返回给我们的响应对象。发送 GET 请求并读取返回数据的完整过程按顺序分为以下 4 步:
- 发起请求:我们调用
http.Get()传入目标网址,获取响应对象resp和错误err。 - 关闭响应体流:确认
err == nil没有报错后,紧接着使用 defer 语句写上defer resp.Body.Close(),确保函数结束时关闭网络连接流。 - 查看状态码:通过
resp.StatusCode查看 HTTP 状态码,例如 200 表示请求成功,404 表示目标地址不存在。 - 读取响应内容:调用
io包的io.ReadAll(resp.Body)将服务器返回的字节数据全部读出来,再按需转换为字符串或解析为结构体。
由于发送真实网络请求需要联网访问外部服务,下面的示例都需要在本地运行。我们先向公开测试接口 httpbin.org 发送一个 GET 请求来看看效果。
示例 1:发送 GET 请求
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
// 1. 发送 GET 请求
resp, err := http.Get("https://httpbin.org/get")
if err != nil {
fmt.Println("请求失败:", err)
return
}
// 2. 函数退出前关闭响应体流
defer resp.Body.Close()
// 3. 查看 HTTP 状态码
fmt.Println("状态码 =", resp.StatusCode)
// 4. 读取服务器返回的全部内容
body, err := io.ReadAll(resp.Body)
if err != nil {
fmt.Println("读取失败:", err)
return
}
fmt.Println(string(body))
}运行结果如下。
状态码 = 200
{
"args": {},
"headers": {
"Host": "httpbin.org",
"User-Agent": "Go-http-client/2.0"
},
"url": "https://httpbin.org/get"
}分析:
http.Get("https://httpbin.org/get") 表示向测试接口发起 GET 请求。当 resp.StatusCode 为 200 时代表请求成功,随后 io.ReadAll(resp.Body) 会读取响应字节并转换成字符串输出。
如果小伙伴们在本地运行时遇到等待较久或超时报错,通常是公开测试站 httpbin.org 跨国网络波动所致,重新执行一次即可。等学完下一节 “Go 搭建 HTTP 服务器” 后,大家也可以在本机起一个 localhost:8080 服务来做零延迟联调。
在编写这段代码时,有一条先后顺序规则一定要记牢:defer resp.Body.Close() 必须写在 if err != nil 判断的后面,千万不能把两者的顺序写反。
// 正确方式
resp, err := http.Get("https://httpbin.org/get")
if err != nil {
return
}
defer resp.Body.Close()
// 错误方式
resp, err := http.Get("https://httpbin.org/get")
defer resp.Body.Close()
if err != nil {
return
}为什么错误方式会有问题呢?当网络断开或域名无法解析时,http.Get() 返回的 err 不为空,此时的 resp 是一个空指针(nil)。如果没判断 err 就先写 defer resp.Body.Close(),函数退出时就会触发 panic 崩溃。
注意: 当目标服务器返回 404 或 500 错误时,只要网络本身连通,http.Get() 返回的 err 依然是 nil。因此判断完 err == nil 后,我们还要检查 resp.StatusCode == http.StatusOK,确认状态码为 200 后再去解析数据。
发送 POST 请求:http.Post()
当我们需要向服务器提交数据时,比如提交登录账号密码、创建订单或发送一段 JSON 数据,通常会使用 POST 请求。在 net/http 包中,我们可以直接调用 http.Post() 函数。
语法:
resp, err := http.Post(url, contentType, body)说明:
http.Post() 一共接收以下 3 个参数:
- url(必选):目标接口的网址字符串。
- contentType(必选):用来告诉服务器请求体的数据格式,发送 JSON 数据时固定填写
"application/json"。 - body(必选):要发送给服务器的数据流,类型为
io.Reader接口。为了支持流式上传大文件而不撑爆内存,http.Post()不直接接收普通字符串。我们需要用strings.NewReader()给字符串套上一个 “出水口”,把它包装成可读数据流再传进去。
示例 2:发送 POST 请求提交 JSON
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
url := "https://httpbin.org/post"
data := strings.NewReader(`{"name": "Lucy", "score": 95}`)
resp, err := http.Post(url, "application/json", data)
if err != nil {
fmt.Println("请求失败:", err)
return
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
fmt.Println("读取失败:", err)
return
}
fmt.Println("状态码 =", resp.StatusCode)
fmt.Println(string(body))
}运行结果如下。
状态码 = 200
{
"data": "{\"name\": \"Lucy\", \"score\": 95}",
"json": {
"name": "Lucy",
"score": 95
},
"url": "https://httpbin.org/post"
}分析:
在这个例子中,我们通过 strings.NewReader() 将准备好的 JSON 字符串包装成可读数据流 data,再传给 http.Post() 发送出去。从返回结果的 "json" 字段可以看到,服务器已经成功解析出了我们提交的 "Lucy" 和 95。
在实际开发中,要提交的数据通常保存在结构体或 Map 中。我们可以先调用 json.Marshal() 将其序列化为字节切片 []byte,再通过 bytes.NewReader() 包装后发送,代码如下:
data, err := json.Marshal(student)
if err != nil {
return err
}
body := bytes.NewReader(data)
resp, err := http.Post(url, "application/json", body)自定义请求头与超时时间
在真实项目开发中,调用外部接口经常还需要做 2 件事:① 在请求头(Header)里携带 Authorization 身份令牌;② 给请求设置超时上限,防止对方服务器无响应导致我们的程序一直卡住等待。
这两个需求使用快捷函数 http.Get() 和 http.Post() 是无法直接配置的,此时我们需要通过带超时配置的 http.Client 配合 http.NewRequest() 来发送请求。
语法:
client := &http.Client{Timeout: 超时时间}
req, err := http.NewRequest(请求方法, 请求网址, 请求体数据流)
req.Header.Set("请求头名称", "请求头的值")
resp, err := client.Do(req)说明:
http.NewRequest() 的第 1 个参数用于指定请求方法,例如 "GET"、"POST"、"PUT" 或 "DELETE"。如果发送的是不需要请求体的 GET 请求,第 3 个参数直接填 nil 即可。
创建好请求对象 req 后,我们可以调用 req.Header.Set() 添加自定义请求头,最后调用 client.Do(req) 将请求发送出去。
示例 3:设置请求头与超时限制
package main
import (
"fmt"
"io"
"net/http"
"time"
)
func main() {
// 1. 创建带有 10 秒超时限制的客户端
client := &http.Client{
Timeout: 10 * time.Second,
}
// 2. 创建自定义请求对象
url := "https://httpbin.org/headers"
req, err := http.NewRequest("GET", url, nil)
if err != nil {
fmt.Println("创建请求失败:", err)
return
}
// 3. 设置自定义请求头
req.Header.Set("User-Agent", "lvyenet-go-client/1.0")
req.Header.Set("Authorization", "Bearer token_123456")
// 4. 发送请求并读取响应
resp, err := client.Do(req)
if err != nil {
fmt.Println("发送请求失败:", err)
return
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
fmt.Println("读取失败:", err)
return
}
fmt.Println(string(body))
}运行结果如下。
{
"headers": {
"Authorization": "Bearer token_123456",
"Host": "httpbin.org",
"User-Agent": "lvyenet-go-client/1.0"
}
}分析:
Timeout: 10 * time.Second 使用了标准库 time 包提供的时间单位,将整个请求的超时限制设为了 10 秒。只要从建立连接到读完响应体超过 10 秒,客户端就会主动中断请求并返回超时错误。
这里小伙伴们要注意,标准库默认的 http.Get() 和 http.Post() 并没有设置超时上限。在实际生产环境中,我们建议统一使用带有 Timeout 的 http.Client 发送请求,避免外部接口卡死拖慢整个服务。
接着我们通过 req.Header.Set() 添加了 User-Agent 和 Authorization 两个请求头。调用 client.Do(req) 发送后,从返回结果可以看到对方服务器准确收到了这两个字段。
编码查询参数并解析 JSON 响应
在真实调用接口时,我们经常既要在网址后面拼接包含中文或空格的查询参数,又要把服务器返回的 JSON 数据直接解析到 Go 结构体里使用。
如果参数里带有中文、空格或 & 这类特殊字符,直接用加号拼字符串很容易导致接口解析错乱。我们可以借助标准库 net/url 包的 url.Values 自动编码查询参数,再用 json.NewDecoder(resp.Body).Decode() 读取响应结果。
语法:
params := url.Values{}
params.Add("参数名", "参数值")
fullURL := baseURL + "?" + params.Encode()
var res 结构体类型
err := json.NewDecoder(resp.Body).Decode(&res)说明:
params.Encode() 会自动对中文、空格等特殊字符做 URL 安全编码,并按 键1=值1&键2=值2 的格式拼接好。
json.NewDecoder(resp.Body) 则会创建一个直接从响应体流读取数据的解码器,紧接着调用 .Decode(&res) 就能按字段名将 JSON 数据填充到结构体变量 res 中,不需要先调用 io.ReadAll() 读取全部字节。
示例 4:编码参数并解析 JSON 响应
package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
"time"
)
type Result struct {
Args map[string]string `json:"args"`
URL string `json:"url"`
}
func main() {
// 1. 使用 url.Values 安全编码查询参数
params := url.Values{}
params.Add("name", "Lucy")
params.Add("course", "Go 教程")
reqURL := "https://httpbin.org/get?" + params.Encode()
client := &http.Client{Timeout: 10 * time.Second}
resp, err := client.Get(reqURL)
if err != nil {
fmt.Println("请求失败:", err)
return
}
defer resp.Body.Close()
// 2. 校验 HTTP 状态码是否为 200
if resp.StatusCode != http.StatusOK {
fmt.Println("状态码异常:", resp.StatusCode)
return
}
// 3. 将响应体 JSON 直接解析到结构体中
var res Result
if err := json.NewDecoder(resp.Body).Decode(&res); err != nil {
fmt.Println("解析 JSON 失败:", err)
return
}
fmt.Println("学员 =", res.Args["name"])
fmt.Println("课程 =", res.Args["course"])
}运行结果如下。
学员 = Lucy
课程 = Go 教程分析:
在这个例子中,params.Encode() 会自动把 "Go 教程" 中的空格和汉字安全编码成符合网络传输规范的查询字符串,服务器收到后就能原样还原出 "Go 教程",不会出现乱码或截断。
确认状态码等于 http.StatusOK(即 200)后,json.NewDecoder(resp.Body).Decode(&res) 直接将响应流里的 JSON 字段填充到了 res 结构体中。
需要注意的是,传给 Decode() 的参数必须是结构体变量的地址 &res。如果漏写了取地址符 &,函数内部将无法把解析出来的数据写入 res 中,并且会直接返回错误。
连接复用与关闭 resp.Body
函数执行结束后局部变量就会自动销毁,为什么每次发送完 HTTP 请求还要专门写一行 defer resp.Body.Close() 呢?
我们可以把发送 HTTP 请求想象成 “打电话咨询客服”:读取 resp.Body 就像是接通电话听客服回答问题,而调用 resp.Body.Close() 则相当于 “听完后挂断电话”。
为了加快连续请求的速度,net/http 默认会保持并复用底层的 TCP 网络连接。想要顺利复用这条连接,需要同时满足 2 个条件:① 在关闭前把 resp.Body 里的数据读完;② 及时调用 resp.Body.Close()。
哪怕某次请求我们只关心状态码、不需要读取正文,也建议先写一行 io.Copy(io.Discard, resp.Body) 把剩余数据排空再关闭,避免高并发时耗尽连接资源。
