本文详解 Go 语言中使用 http.NewRequest 发送含空格（或特殊字符）的 POST 表单参数时的正确编码方法，重点介绍 net/url.Values 的标准 URL 编码实践，避免手动拼接 URL 导致的乱码、截断或 400 错误。
本文详解 go 语言中使用 `http.newrequest` 发送含空格（或特殊字符）的 post 表单参数时的正确编码方法，重点介绍 `net/url.values` 的标准 url 编码实践，避免手动拼接 url 导致的乱码、截断或 400 错误。
在 Go 中通过 HTTP 发送 POST 请求时，若请求参数值包含空格、@、、/ 等非 URL 安全字符（如 SSH 公钥字符串 "ssh-rsa abcde user@example.com"），绝不可直接拼接进 URL 查询字符串或裸体写入请求体——这不仅违反 RFC 3986 规范，更会导致服务端解析失败、参数截断，甚至引发安全风险。
正确做法是：将参数组织为 url.Values，调用 .Encode() 方法生成符合 application/x-www-form-urlencoded 标准的请求体，并显式设置 Content-Type 头。该方法等效于 curl --data-urlencode，会自动将空格转为 +、中文转为 %E4%BD%A0%E5%A5%BD 等合法编码。
以下是一个完整、可运行的示例：
package main
import (
"bytes"
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
// 构建带空格和特殊字符的参数值（模拟 SSH 公钥）
sshKey := "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQD... user@example.com"
// 使用 url.Values 安全编码
data := url.Values{}
data.Set("key", sshKey) // 自动处理空格、@、/、= 等所有需转义字符
// 创建 POST 请求：注意 URL 不含查询参数，请求体为编码后的数据
req, err := http.NewRequest("POST", "https://website.com/api", bytes.NewBufferString(data.Encode()))
if err != nil {
panic(err)
}
// 关键：设置标准表单编码头
req.Header.Set("Content-Type", "application/x-www-form-urlencoded")
// 发送请求
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Printf("Status: %s\nResponse: %s\n", resp.Status, string(body))
}✅ 关键要点总结：
- ❌ 错误方式："https://api?key=" + sshKey —— 未编码，空格导致 URL 解析中断；
- ✅ 正确方式：url.Values{}.Set().Encode() 生成请求体，配合 Content-Type: application/x-www-form-urlencoded；
- ⚠️ 注意事项：
- 不要混用 GET 查询参数与 POST 表单体；本例应保持 URL 干净（无 ?key=...），全部参数置于请求体；
- 若需发送 JSON，则应改用 json.Marshal + Content-Type: application/json，此时空格无需额外编码（JSON 字符串本身已定义转义规则）；
- url.Values.Encode() 输出使用 + 代替空格，符合 HTML 表单规范，服务端（如 PHP $_POST、Python Flask request.form、Node.js body-parser）可直接解析。
遵循此模式，即可稳健、兼容地发送任意含空格、邮箱、路径、Unicode 的表单参数，真正实现与 curl --data-urlencode 行为一致的 Go 原生实现。
