如何在 Go 中为 API 客户端正确发送嵌套 JSON 请求体-Golang-PHP中文网

如何在 Go 中为 API 客户端正确发送嵌套 JSON 请求体

Go 的 url.Values 不支持嵌套结构，若需向 API 提交嵌套数据（如 Transmission RPC），应改用 JSON 编码 + http.NewRequest，而非 http.PostForm。

go 的 `url.values` 不支持嵌套结构，若需向 api 提交嵌套数据（如 transmission rpc），应改用 json 编码 + `http.newrequest`，而非 `http.postform`。

在 Go 开发中，url.Values 是一个 map[string][]string 类型，专为表单编码（application/x-www-form-urlencoded）设计，天然不支持嵌套对象或数组。因此，像以下写法在语法和语义上均非法：

reqBody := url.Values{
    "method": {"server-method"},
    "arguments": {  // ❌ 编译报错：unexpected {: 无法将 map 或 struct 字面量作为 []string 元素
        "download-dir": {"/path/to/downloads/dir"},
        "filename":     {variableWithURL},
        "paused":       {"false"},
    },
}

此类错误（如 syntax error: unexpected :、non-declaration statement outside function body）本质是 Go 语法限制：url.Values 的每个值必须是 []string，而内层花括号试图构造非字符串切片，导致解析失败。

✅ 正确做法是：放弃 PostForm，改用标准 JSON 流程：

定义结构体并标注 JSON tag，清晰表达嵌套层级；
序列化为 JSON 字节流；
*手动构造 `http.Request，设置Content-Type: application/json`**；
使用 http.DefaultClient.Do() 发送。

示例实现如下：

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

type Command struct {
    Method    string    `json:"method,omitempty"`
    Arguments Arguments `json:"arguments,omitempty"`
}

type Arguments struct {
    DownloadDir string `json:"download-dir,omitempty"`
    Filename    string `json:"filename,omitempty"`
    Paused      bool   `json:"paused,omitempty"`
}

// 构造请求体
reqBody := Command{
    Method: "torrent-add",
    Arguments: Arguments{
        DownloadDir: "/path/to/downloads/dir",
        Filename:    variableWithURL,
        Paused:      false, // 注意：bool 类型更安全，避免字符串解析歧义
    },
}

jsonBytes, err := json.Marshal(reqBody)
if err != nil {
    return fmt.Errorf("failed to marshal JSON: %w", err)
}

req, err := http.NewRequest("POST", c.URL, bytes.NewReader(jsonBytes))
if err != nil {
    return fmt.Errorf("failed to create request: %w", err)
}
req.Header.Set("Content-Type", "application/json") // ⚠️ 关键：显式设置 header

resp, err := http.DefaultClient.Do(req)
if err != nil {
    return fmt.Errorf("request failed: %w", err)
}
defer resp.Body.Close()

? 关键注意事项：

http.PostForm 仅适用于扁平表单，不可用于任何嵌套或复杂结构；
json.Marshal 会自动处理 omitempty、类型转换（如 bool → true/false）和转义，比手动拼接字符串更健壮；
务必设置 Content-Type: application/json，否则服务端可能拒绝解析或误判为表单；
若 API 要求认证（如 Basic Auth 或 Token），需通过 req.Header.Set() 添加对应头字段；
对于高频调用，建议复用 http.Client 实例并配置超时，避免资源泄漏。