Go 的 url.Values 不支持嵌套结构，若需发送含嵌套字段（如对象内含对象）的 API 请求，应改用 json.Marshal 序列化结构体，并通过 http.NewRequest 发送 JSON 格式请求体，而非 http.PostForm。
go 的 `url.values` 不支持嵌套结构，若需发送含嵌套字段（如对象内含对象）的 api 请求，应改用 `json.marshal` 序列化结构体，并通过 `http.newrequest` 发送 json 格式请求体，而非 `http.postform`。
在 Go 中，url.Values 本质上是 map[string][]string，仅支持扁平化的键值对（如 "key": {"value"}），无法直接表达 JSON 中的嵌套对象或数组。因此，以下写法是非法的，会导致编译错误：
// ❌ 错误：url.Values 不允许嵌套 map 或 struct 字面量
reqBody := url.Values{
"method": {"server-method"},
"arguments": { // 编译器报错：unexpected {: expecting }
"download-dir": {"/path/to/downloads/dir"},
"filename": {variableWithURL},
"paused": {"false"},
},
}
正确的做法是：放弃 http.PostForm，转而使用 json 包序列化结构体，并以 application/json 类型发送请求。
✅ 推荐方案：结构体 + JSON 序列化
首先定义清晰、可映射 JSON 的结构体（注意导出字段和 JSON tag）：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
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: "server-method",
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 request: %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")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
return fmt.Errorf("request failed: %w", err)
}
defer resp.Body.Close()
⚠️ 注意事项
-
不要混用
PostForm和嵌套数据：PostForm专为application/x-www-form-urlencoded设计，仅适用于扁平表单；嵌套需求天然属于 JSON 场景。 -
字段必须首字母大写（导出）：否则
json.Marshal无法访问字段，返回空对象{}。 -
合理使用
omitempty：避免零值字段污染请求体（如空字符串、false、0）。 -
显式设置
Content-Type：服务端通常依赖该 Header 判断解析方式，缺失可能导致 400 或静默失败。 -
错误处理不可省略：JSON 序列化、HTTP 请求、响应读取均可能失败，建议逐层包装错误（如
fmt.Errorf("...: %w", err)）。
✅ 总结
当 API 要求嵌套 JSON（如 RPC 风格接口：Transmission、Jellyfin、Home Assistant 等），请坚定选择结构体 + json.Marshal + http.NewRequest 组合。这不仅是语法正确的解法，更是语义清晰、类型安全、易于维护的 Go 惯用实践。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
