Go 中发送带数据的 POST 请求：正确设置表单编码与请求头_技术教程

本文详解如何在 go 中正确构造携带表单数据（application/x-www-form-urlencoded）的 post 请求，解决因缺失 content-type 或数据未正确编码导致 api 返回“无 post 数据”的常见问题。

在 Go 中发起带参数的 POST 请求时，仅将 url.Values 编码为字符串并写入请求体是不够的——必须显式设置 Content-Type 请求头，否则服务端（尤其是 PHP、Rails 或基于表单解析的 API）无法识别为标准表单提交，从而忽略请求体内容。

你提供的原始代码中存在三个关键问题：

缺失 Content-Type 头：http.NewRequest 创建的请求默认无 Content-Type，而 curl -d 会自动添加 application/x-www-form-urlencoded；
defer resp.Body.Close() 位置错误：在 err == nil 判断前执行 defer，若请求失败（err != nil），resp 为 nil，resp.Body.Close() 将 panic；
忽略错误处理：未检查 http.NewRequest 和 client.Do 的错误，掩盖了底层失败原因。

✅ 正确做法如下（推荐两种等效方式）：

✅ 方式一：使用 http.PostForm（最简洁，专用于表单）

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 内部自动设置 Content-Type: application/x-www-form-urlencoded 并编码数据，适合纯表单场景。

✅ 方式二：手动构建请求（更灵活，便于扩展）

package main

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

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

    // 关键：用 strings.NewReader 替代 bytes.NewBufferString（语义更清晰）
    // 并务必设置 Content-Type
    req, err := http.NewRequest("POST", apiUrl, bytes.NewBufferString(data.Encode()))
    if err != nil {
        fmt.Printf("创建请求失败: %v\n", err)
        return
    }
    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))
}

⚠️ 注意事项与最佳实践

永远检查 err：http.NewRequest 和 client.Do 均可能返回错误，不可忽略；
defer resp.Body.Close() 必须在 resp 非 nil 后调用：即放在 if err != nil { ... return } 之后；
避免 ioutil.ReadAll 的潜在内存风险：生产环境建议用流式处理或限制响应大小（Go 1.16+ 推荐 io.Copy 或 io.LimitReader）；
bytes.NewBufferString(data.Encode()) 是合法的，但 strings.NewReader(data.Encode()) 更轻量（只读场景），二者均可；
若需发送 JSON，请改用 application/json + json.Marshal，切勿混用表单编码。

掌握这两种方式，即可稳定对接绝大多数 RESTful 表单 API。优先选用 http.PostForm 简化开发；当需自定义 Header、超时、重试等高级配置时，再采用手动构建方式。