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

本文详解 go 语言中发送 `application/x-www-form-urlencoded` 类型 post 请求的正确方法，涵盖 `http.postform` 的便捷用法、手动构造请求时的关键要点（如设置 content-type、正确编码数据），并提供健壮的错误处理与资源释放范式。

在 Go 中向 Web API 发送表单格式的 POST 请求（即类似 curl -d "key=val" 的行为）时，仅将 url.Values 编码后作为请求体是不够的——必须显式设置 Content-Type: application/x-www-form-urlencoded 头，否则服务端通常无法识别并解析请求数据，导致“无 POST 数据”的错误。

✅ 推荐方案一：使用 http.PostForm（最简洁可靠）

该函数专为表单提交设计，自动设置正确的 Content-Type 并编码数据：

package main

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

func main() {
    apiUrl := "https://example.com/api/"
    data := url.Values{
        "api_token": {"MY_KEY"},
        "action":    {"list_projects"},
    }

    resp, err := http.PostForm(apiUrl, data)
    if err != nil {
        fmt.Printf("请求失败: %v\n", err)
        return
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Printf("读取响应失败: %v\n", err)
        return
    }

    fmt.Println("状态:", resp.Status)
    fmt.Println("响应:", string(body))
}

? http.PostForm 内部已调用 data.Encode() 并设置 Content-Type，无需额外操作，适合绝大多数表单场景。

✅ 推荐方案二：手动构造 *http.Request（更灵活可控）

当需要自定义 Header、超时、重试逻辑或使用自定义 http.Client 时，应手动构建请求，并务必设置 Content-Type：

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
    "net/url"
    "strings" // 注意：使用 strings.NewReader 而非 bytes.NewBufferString
)

func main() {
    apiUrl := "https://example.com/api/"
    data := url.Values{
        "api_token": {"MY_KEY"},
        "action":    {"list_projects"},
    }

    req, err := http.NewRequest("POST", apiUrl, strings.NewReader(data.Encode()))
    if err != nil {
        fmt.Printf("创建请求失败: %v\n", err)
        return
    }

    // ⚠️ 关键：必须设置 Content-Type！
    req.Header.Set("Content-Type", "application/x-www-form-urlencoded")

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

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Printf(
"读取响应体失败: %v\n", err)
        return
    }

    fmt.Println("状态:", resp.Status)
    fmt.Println("响应:", string(body))
}

⚠️ 常见错误与注意事项

• bytes.NewBufferString 不是错误，但 strings.NewReader 更轻量且语义更清晰（data.Encode() 返回 string，非 []byte）；
• defer resp.Body.Close() 必须在 err == nil 后调用，否则可能 panic（resp 为 nil）；
• 永远检查 err != nil 并提前返回，避免后续对 nil resp 或 body 的操作；
• ioutil.ReadAll 在 Go 1.16+ 已被弃用，生产环境建议升级为 io.ReadAll（需 import "io"）；
• 若 API 要求 JSON，请改用 json.Marshal + Content-Type: application/json，而非 url.Values。

掌握这两种方式，即可稳定、可维护地完成 Go 中的表单 POST 请求，彻底告别 “no data in POST request” 错误。