如何正确解析 HTTP 请求中的表单数据（POST/PUT 表单）-Golang-PHP中文网

如何正确解析 HTTP 请求中的表单数据（POST/PUT 表单）

Go 的 http.Request 中 r.PostForm 和 r.Form 为空，通常是因为请求缺少正确的 Content-Type: application/x-www-form-urlencoded 头，导致 ParseForm() 无法识别并解析表单键值对。

go 的 `http.request` 中 `r.postform` 和 `r.form` 为空，通常是因为请求缺少正确的 `content-type: application/x-www-form-urlencoded` 头，导致 `parseform()` 无法识别并解析表单键值对。

在 Go 的 HTTP 处理中，r.ParseForm() 并非无条件解析请求体——它仅对特定 Content-Type 的请求生效。根据 Go 源码（net/http/request.go）和 RFC 规范，ParseForm() 会检查请求头：

✅ 若 Content-Type == "application/x-www-form-urlencoded"：自动解析为 r.PostForm（对 POST/PUT 等非 GET/HEAD 方法）和 r.Form（统一解析）；
❌ 若 Content-Type 未设置、为 application/octet-stream（RFC 2616 默认）、text/plain、application/json 或其他类型：r.PostForm 始终为空，即使请求体是合法的 key=value&... 格式。

你遇到的问题正是如此：虽然发送的是标准 URL 编码表单（Name=someName&Version=1.0.0...），但客户端未显式设置 Content-Type: application/x-www-form-urlencoded，Go 将其视为二进制流，跳过表单解析。

✅ 正确的客户端请求示例（cURL）：

curl -X PUT http://localhost:8080/api/app \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "Name=someName" \
  -d "Version=1.0.0" \
  -d "PLanguage=java" \
  -d "GitRepo=someRepo"

✅ 在 Go 服务端，确保调用 ParseForm() 且仅在正确 Content-Type 下依赖 r.PostForm：

func (h *MyHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
    // 注意：ParseForm 可能因 Content-Type 不匹配而静默失败（不报错但不填充）
    if err := r.ParseForm(); err != nil {
        http.Error(w, "Invalid form data", http.StatusBadRequest)
        return
    }

    // ✅ 安全访问：r.PostForm 仅在 application/x-www-form-urlencoded 下有效
    name := r.PostFormValue("Name")           // 推荐：简洁安全
    version := r.PostFormValue("Version")

    log.Printf("Parsed: Name=%s, Version=%s", name, version)

    // ⚠️ 注意：r.Body 在 ParseForm() 后已读取并关闭，不可重复读取
    // 若需原始字节，请在 ParseForm() 前用 ioutil.ReadAll(r.Body) 保存（并重置 Body）
}

⚠️ 关键注意事项：

r.ParseForm() 对 GET/HEAD 解析查询参数到 r.Form；对 POST/PUT/DELETE 等方法，若 Content-Type 匹配，则同时解析 body 到 r.PostForm 和 r.Form；
不要依赖 r.Body 在 ParseForm() 后仍可读——它已被消耗。如需原始内容，请先缓存；
若必须处理非标准 Content-Type 的表单（如 text/plain 包含 URL 编码字符串），需手动解码：
```
body, _ := io.ReadAll(r.Body)
values, _ := url.ParseQuery(string(body)) // 手动解析
```