使用 http.NewRequest 发送 URL 编码的 POST 请求

本文介绍了如何使用 Go 语言的 `net/http` 包中的 `http.NewRequest` 函数来发送 `application/x-www-form-urlencoded` 格式的 POST 请求。重点在于如何正确地将 URL 编码的数据作为请求体传递，避免常见的 400 Bad Request 错误，并提供可直接运行的代码示例。

在使用 Go 语言发送 HTTP 请求时，http.NewRequest 函数是一个强大的工具，它允许你完全控制请求的各个方面，包括方法、URL、头部和请求体。当需要发送 application/x-www-form-urlencoded 格式的 POST 请求时，理解如何正确地构建请求体至关重要。

关键在于请求体 (Body)

http.NewRequest 函数的签名是 http.NewRequest(method, urlStr string, body io.Reader)。 其中 body 参数的类型是 io.Reader，这意味着你可以将任何实现了 io.Reader 接口的对象作为请求体。对于 application/x-www-form-urlencoded 格式的数据，我们需要将数据进行 URL 编码，然后将其作为 io.Reader 传递。

示例代码

以下是一个完整的示例，展示了如何使用 http.NewRequest 发送一个包含 URL 编码数据的 POST 请求：

package main

import (
    "fmt"
    "net/http"
    "net/url"
    "strings"
)

func main() {
    apiUrl := "https://api.example.com" // 替换为你的 API 地址
    resource := "/user/"

    // 准备 URL 编码的数据
    data := url.Values{}
    data.Set("name", "foo")
    data.Set("surname", "bar")

    // 构建完整的 URL
    u, err := url.ParseRequestURI(apiUrl)
    if err != nil {
        fmt.Println("Error parsing URL:", err)
        return
    }
    u.Path = resource
    urlStr := u.String() // "https://api.example.com/user/"

    // 创建 HTTP 客户端
    client := &http.Client{}

    // 创建请求
    reqBody := strings.NewReader(data.Encode()) // 将 URL 编码的数据转换为 io.Reader
    r, err := http.NewRequest(http.MethodPost, urlStr, reqBody)
    if err != nil {
        fmt.Println("Error creating request:", err)
        return
    }

    // 设置请求头部
    r.Header.Add("Authorization", "auth_token=\"XXXXXXX\"") // 替换为你的认证 token
    r.Header.Add("Content-Type", "application/x-www-form-urlencoded")

    // 发送请求
    resp, err := client.Do(r)
    if err != nil {
        fmt.Println("Error sending request:", err)
        return
    }
    defer resp.Body.Close()

    // 打印响应状态
    fmt.Println("Response Status:", resp.Status)
}

代码解析

1. 准备数据： 使用 url.Values 类型来存储要发送的数据，并使用 data.Set() 方法设置键值对。
2. URL 编码： 使用 data.Encode() 方法将数据进行 URL 编码，生成一个字符串，例如 "name=foo&surname=bar"。
3. 创建 io.Reader： 使用 strings.NewReader() 函数将 URL 编码的字符串转换为 io.Reader。 这是关键的一步，它将数据准备好作为请求体传递。
4. 创建请求： 使用 http.NewRequest 函数创建一个新的 POST 请求，并将 io.Reader 作为 body 参数传递。
5. 设置头部： 设置 Content-Type 头部为 application/x-www-form-urlencoded，以及其他必要的头部，例如 Authorization。
6. 发送请求： 使用 http.Client.Do() 方法发送请求并处理响应。

注意事项

• Content-Length 头部： 在较新的 Go 版本中，http.Client 会自动计算并设置 Content-Length 头部。 如果手动设置，确保其值与请求体的实际长度一致，否则可能导致问题。 在上面的例子中，不需要手动设置Content-Length。
• 错误处理： 在实际应用中，务必添加完善的错误处理机制，例如检查 url.ParseRequestURI、http.NewRequest 和 client.Do 的返回值，并进行适当的错误处理。
• API 地址： 确保将 apiUrl 变量替换为实际的 API 地址。
• 认证信息： 将 auth_token 替换为实际的认证 token。
• HTTPS: 如果你的 API 使用 HTTPS，请确保你的客户端配置正确，可以验证服务器的证书。

总结

通过将 URL 编码的数据作为 io.Reader 传递给 http.NewRequest 函数，可以轻松地发送 application/x-www-form-urlencoded 格式的 POST 请求。 记住，正确的设置 Content-Type 头部，并处理潜在的错误，是确保请求成功的关键。