本文详解如何为符合标准 JSON 规范的 REST 响应设计 Go 结构体，重点解决因 JSON 格式错误（如误用 {[...]}）导致的 json.Unmarshal 失败问题，并提供可直接运行的结构体定义与验证示例。
本文详解如何为符合标准 json 规范的 rest 响应设计 go 结构体，重点解决因 json 格式错误（如误用 `{[...]}`）导致的 `json.unmarshal` 失败问题，并提供可直接运行的结构体定义与验证示例。
在 Go 中使用 json.Unmarshal 解析 REST API 响应时，结构体定义必须严格匹配 JSON 的实际语法结构。您提供的原始响应片段：
"Basket" : {
"Count": 1,
"Fruits": {[
{"Name":"Mango", "Season":"Summer"},
{"Name":"Fig", "Season":"Winter"}
]}
}⚠️ 这不是合法的 JSON —— {[...]} 是语法错误。JSON 标准中，方括号 [] 表示数组（array），花括号 {} 表示对象（object），二者不可嵌套成 {[...]} 形式。该写法既不是有效对象，也不是有效数组，任何合规的 JSON 解析器（包括 Go 的 encoding/json）都会拒绝解析。
✅ 正确的 JSON 应为以下两种之一：
-
情况一（推荐）：
Fruits是数组（最常见）{ "Basket": { "Count": 1, "Fruits": [ {"Name":"Mango", "Season":"Summer"}, {"Name":"Fig", "Season":"Winter"} ] } }对应 Go 结构体（需完整嵌套）：
type Response struct { Basket Basket `json:"Basket"` } type Basket struct { Count int `json:"Count"` Fruits []Fruit `json:"Fruits"` } type Fruit struct { Name string `json:"Name"` Season string `json:"Season"` }✅ 使用示例：
data := []byte(`{"Basket":{"Count":1,"Fruits":[{"Name":"Mango","Season":"Summer"},{"Name":"Fig","Season":"Winter"}]}}`) var resp Response if err := json.Unmarshal(data, &resp); err != nil { log.Fatal(err) // 若 JSON 合法，此处无错误 } fmt.Printf("Count: %d, First fruit: %s\n", resp.Basket.Count, resp.Basket.Fruits[0].Name) // 输出：Count: 1, First fruit: Mango -
情况二：
Fruits是键值映射（如按 ID 索引）
若后端本意是返回对象（例如"Fruits": {"mango": {...}, "fig": {...}}），则结构体应改为：type Basket struct { Count int `json:"Count"` Fruits map[string]Fruit `json:"Fruits"` // 注意：字段类型为 map }但此场景与您给出的
[...]内容明显矛盾，故不适用。
? 关键注意事项：
- Go 结构体标签（如
`json:"Count"`）用于指定 JSON 字段名映射，大小写与下划线规则需与实际 JSON 一致； - 嵌套层级必须与 JSON 对象层级完全对应（
Basket是顶层字段，不可省略）； - 使用 JSONLint 或
go run -gcflags="-l" main.go配合json.Valid()可提前校验 JSON 合法性； - 若第三方 API 确实返回
{[...]}这类非法格式，必须在反序列化前通过字符串预处理（不推荐）或联系服务方修复 —— 绝不应妥协于非标 JSON。
总结：您的原始结构体逻辑正确，问题根源在于输入 JSON 本身违反规范。修复 JSON 格式后，配合精准的嵌套结构体定义，即可实现零误差反序列化。
