本文详解 Go 中解析顶层 JSON 数组（而非对象）的常见误区，指出需直接反序列化为 []Transaction 切片而非嵌套结构体，并强调字段导出与标签匹配的关键要求。
本文详解 go 中解析顶层 json 数组（而非对象）的常见误区，指出需直接反序列化为 `[]transaction` 切片而非嵌套结构体，并强调字段导出与标签匹配的关键要求。
在 Go 中解析 JSON 数据时，一个高频错误是：将顶层为 JSON 数组（如 [{"amount":"..."}, {...}]）的响应，误用嵌套结构体（如 TransactionResponse{Transaction: []Transaction}）进行 json.Unmarshal。这会导致解析失败（err != nil）或字段为空，因为 Go 的 encoding/json 包无法自动将数组映射到含单个切片字段的结构体——它严格按 JSON 结构层级匹配。
正确的做法是直接将 JSON 数组反序列化为 Go 的切片类型。例如，针对如下 JSON 响应：
[
{
"amount": "6.40000000",
"date": "1439165701",
"price": "350.26",
"tid": 104159
},
{
"amount": "0.10025000",
"date": "1439162764",
"price": "351.03",
"tid": 104150
}
]应定义导出的结构体（首字母大写），并确保所有字段均可被 JSON 包访问：
type Transaction struct {
Amount string `json:"amount"`
Date string `json:"date"`
Price string `json:"price"`
Tid uint `json:"tid"` // 注意：tid → Tid（导出），否则无法反序列化
}然后在主逻辑中直接解码为 []Transaction：
func main() {
resp, err := http.Get("https://api.example.com/transactions")
if err != nil {
log.Fatal("HTTP request failed:", err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
log.Fatal("Failed to read response body:", err)
}
var transactions []Transaction
if err := json.Unmarshal(body, &transactions); err != nil {
log.Fatal("JSON unmarshal failed:", err)
}
fmt.Printf("Parsed %d transactions\n", len(transactions))
for _, t := range transactions {
fmt.Printf("TID: %d, Amount: %s, Price: %s\n", t.Tid, t.Amount, t.Price)
}
}⚠️ 关键注意事项：
- 字段必须导出：Go 中只有首字母大写的字段（如 Tid）才能被 json 包读写；小写字段（如 tid）会被忽略，导致值为零值。
- 不要包装多余结构体：若 JSON 是纯数组，无需定义 TransactionResponse 类型。强行使用会导致 json: cannot unmarshal array into Go value of type TransactionResponse 错误。
- 错误处理不可省略：http.Get 返回的是 *http.Response，需检查 err；resp.Body 必须关闭；json.Unmarshal 的错误需显式判断。
- 类型一致性："tid": 104159 是 JSON number，对应 Go 的 uint 可行，但更推荐 int64 或 float64 以兼容更大整数或潜在浮点 ID；若确定为无符号整数且范围可控，uint 亦可。
✅ 总结：解析顶层 JSON 数组 = 直接 json.Unmarshal(data, &[]Struct{}) + 所有结构体字段首字母大写 + 正确 json 标签。这是 Go JSON 处理中最基础也最易踩坑的一环，掌握后可大幅提升 API 集成效率。
