如何在 Go 中正确发送带数据的 POST 请求

在Go语言的后端开发场景中，向第三方接口或者服务内部的其他模块发送带数据的POST请求是非常高频的操作，正确使用标准库的相关能力可以高效完成这类需求。

基础环境准备

Go语言发送HTTP请求主要依赖标准库中的net/http包，无需额外安装第三方依赖，直接导入即可使用。如果需要处理JSON数据，还需要导入encoding/json包，处理表单数据则需要net/url包。

发送表单类型数据的POST请求

表单数据是POST请求中常见的数据格式，对应的Content-Type为application/x-www-form-urlencoded，实现步骤如下：

步骤1：构造表单数据

使用url.Values类型构造表单参数，然后调用Encode()方法转换为字符串格式。

步骤2：创建请求并设置请求头

调用http.Post方法或者先创建http.Request对象再设置请求头，这里推荐使用后者，方便自定义更多请求参数。

完整代码示例

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
)

func main() {
    // 构造表单数据
    formData := url.Values{}
    formData.Set("username", "test_user")
    formData.Set("password", "test_pass")
    // 转换为请求体需要的字符串格式
    body := formData.Encode()

    // 创建POST请求
    req, err := http.NewRequest("POST", "http://127.0.0.1:8080/login", nil)
    if err != nil {
        fmt.Println("创建请求失败:", err)
        return
    }
    // 设置Content-Type为表单格式
    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
    // 设置请求体
    req.Body = ioutil.NopCloser(strings.NewReader(body))

    // 发送请求
    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("发送请求失败:", err)
        return
    }
    defer resp.Body.Close()

    // 读取响应内容
    respData, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("读取响应失败:", err)
        return
    }
    fmt.Println("响应结果:", string(respData))
}

发送JSON类型数据的POST请求

JSON格式是接口交互中最常用的数据格式，对应的Content-Type为application/json，实现方式和表单数据类似，只是数据构造和请求头设置不同。

步骤1：构造JSON数据

定义结构体，将结构体实例序列化为JSON字节流。

步骤2：设置对应请求头并发送请求

完整代码示例如下：

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

// 定义请求参数结构体
type UserReq struct {
    Name  string `json:"name"`
    Age   int    `json:"age"`
    Email string `json:"email"`
}

func main() {
    // 构造请求参数
    reqData := UserReq{
        Name:  "张三",
        Age:   25,
        Email: "test@ipipp.com",
    }
    // 序列化为JSON
    jsonData, err := json.Marshal(reqData)
    if err != nil {
        fmt.Println("JSON序列化失败:", err)
        return
    }

    // 创建POST请求
    req, err := http.NewRequest("POST", "http://127.0.0.1:8080/user/add", bytes.NewBuffer(jsonData))
    if err != nil {
        fmt.Println("创建请求失败:", err)
        return
    }
    // 设置Content-Type为JSON格式
    req.Header.Set("Content-Type", "application/json")

    // 发送请求
    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("发送请求失败:", err)
        return
    }
    defer resp.Body.Close()

    // 读取响应
    respData, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("读取响应失败:", err)
        return
    }
    fmt.Println("响应结果:", string(respData))
}

常见问题与注意事项

• 请求发送后一定要关闭响应体resp.Body，否则会造成资源泄漏，建议使用defer关键字确保执行。
• 如果请求需要设置超时时间，可以通过http.Client的Timeout字段配置，避免长时间等待。
• 发送JSON数据时，结构体字段的tag需要正确设置，否则序列化后的字段名不符合预期。
• 如果服务端需要鉴权，可以在请求头中添加对应的Token字段，例如req.Header.Set("Authorization", "Bearer xxx")。

总结

Go中发送带数据的POST请求核心是使用net/http包构造请求、设置正确的请求头和数据格式，根据不同的数据格式选择对应的处理方式即可。实际开发中可以根据需求封装通用的请求方法，减少重复代码，提升开发效率。

GoPOST请求http_client数据发送net_http修改时间：2026-06-09 00:18:50