本文详解go中json.unmarshal解析json数组的核心原则——必须严格匹配json数据的顶层结构：数组对应[]t切片，对象对应struct；若用结构体接收纯数组会静默失败并返回零值。
本文详解go中json.unmarshal解析json数组的核心原则——必须严格匹配json数据的顶层结构：数组对应[]t切片，对象对应struct；若用结构体接收纯数组会静默失败并返回零值。
在Go语言中，encoding/json包对JSON数组的反序列化（Unmarshal）有明确且严格的类型契约：JSON输入的根节点类型必须与目标Go类型的顶层结构完全一致。这是初学者最容易踩坑的关键点——看似相似的代码，结果却天差地别，根源往往不在语法错误，而在“结构错配”。
以问题中的代码为例：
keysBody := []byte(`[{"id": 1,"key": "-"},{"id": 2,"key": "-"},{"id": 3,"key": "-"}]`)
keys := make([]PublicKey, 0)
json.Unmarshal(keysBody, &keys) // ✅ 成功：JSON是数组 → Go目标是[]PublicKey切片指针这段能成功，是因为keysBody是以[开头的纯JSON数组，而&keys是指向[]PublicKey的指针，类型完全匹配。
但紧接着：
立即学习“go语言免费学习笔记（深入）”；
response := KeysResponse{}
json.Unmarshal(keysBody, &response) // ❌ 失败：JSON是数组，但KeysResponse是struct（隐含对象语义）这里就触发了经典错误：json: cannot unmarshal array into Go value of type main.KeysResponse。
因为KeysResponse是一个结构体，其默认映射的JSON格式应为对象（object），即以{开头、包含字段名的键值对结构，例如：
{
"Collection": [{"id":1,"key":"-"}, {"id":2,"key":"-"}]
}而传入的却是[开头的数组——Go的JSON解码器无法将一个数组“塞进”一个期待对象的结构体里，故直接报错。
✅ 正确实践：按需选择目标类型
| JSON 格式（根节点） | 推荐 Go 目标类型 | 示例代码 |
|---|---|---|
| [{"a":1},{"b":2}] | []YourStruct | var items []User; json.Unmarshal(data, &items) |
| {"data":[...], "meta":{}} | struct { Data []User; Meta MetaInfo } | var resp struct{ Data []User; Meta MetaInfo }; json.Unmarshal(data, &resp) |
| 不确定（可能[]或{}） | json.RawMessage + 分支处理 | 见下文 |
? 补充技巧：安全封装数组到结构体
若业务逻辑要求统一使用KeysResponse结构体，但上游只提供纯数组，不要强行Unmarshal，而应先解到切片，再构造结构体：
keys := []PublicKey{}
if err := json.Unmarshal(keysBody, &keys); err != nil {
log.Fatal(err)
}
response := KeysResponse{Collection: keys} // ✅ 显式赋值，清晰可控
fmt.Printf("%#v\n", response)⚠️ 关键注意事项（避坑清单）
- 字段导出性：结构体字段必须首字母大写（如Id, Key），否则json.Unmarshal会静默跳过；
- JSON Tag 必须显式声明：即使字段名一致，也建议写json:"id"，避免依赖默认转换规则（如ID→id）；
- 空切片 vs nil切片：make([]T, 0)和[]T(nil)均可作为Unmarshal目标，但前者更安全（避免nil panic）；
- 错误检查不可省略：err != nil是唯一可靠判断依据，切勿仅靠打印结果是否为空来断定成功；
- 嵌套数组/异构场景：若JSON数组内元素结构不一（如混合对象与字符串），优先用[]json.RawMessage分步解析，而非强求单一结构体。
? 总结
Go的JSON反序列化不是“尽力而为”，而是“严丝合缝”。理解[...] ↔ []T 和 {...} ↔ struct 的一一映射关系，是写出健壮JSON处理逻辑的第一步。与其反复调试cannot unmarshal错误，不如在写代码前先用一句话描述JSON结构：“这是一个以[开头的数组，每个元素是含id和key字段的对象”——这句话自然就导出了正确的Go类型：[]PublicKey。
