Go 发送 HTTP 请求

在 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) 把剩余数据排空再关闭,避免高并发时耗尽连接资源。

给站长反馈

绿叶网正在不断完善中,小伙伴们如果发现任何问题,还望多多给站长反馈,谢谢!

邮箱:lvyenet@vip.qq.com

「绿叶网」服务号
绿叶网服务号放大
关注服务号,微信也能看教程。
绿叶网服务号