本文介绍了如何使用 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 请求：
本接口为腾讯云短信发送接口，页面代码全部采用 ASP 语句编写，方便使用ASP开发者应用到自己开发的业务中。只需将腾讯云短信申请的4个参数值填入即可使用，无需其它改动。申明：本接口为本人原创。
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)
}代码解析
- 准备数据： 使用 url.Values 类型来存储要发送的数据，并使用 data.Set() 方法设置键值对。
- URL 编码： 使用 data.Encode() 方法将数据进行 URL 编码，生成一个字符串，例如 "name=foo&surname=bar"。
- 创建 io.Reader： 使用 strings.NewReader() 函数将 URL 编码的字符串转换为 io.Reader。 这是关键的一步，它将数据准备好作为请求体传递。
- 创建请求： 使用 http.NewRequest 函数创建一个新的 POST 请求，并将 io.Reader 作为 body 参数传递。
- 设置头部： 设置 Content-Type 头部为 application/x-www-form-urlencoded，以及其他必要的头部，例如 Authorization。
- 发送请求： 使用 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 头部，并处理潜在的错误，是确保请求成功的关键。
