Go 中 JSON 反序列化失败的常见原因：结构体嵌套不匹配问题-Golang-PHP中文网

Go 中 JSON 反序列化失败的常见原因：结构体嵌套不匹配问题

本文解析 Go 语言中 json.Unmarshal 或 json.Decoder.Decode 报错 “cannot unmarshal object into Go value of type []main.Track” 的根本原因——JSON 数据结构与 Go 结构体字段嵌套层级不一致，并提供精准修复方案与最佳实践。

本文解析 go 语言中 `json.unmarshal` 或 `json.decoder.decode` 报错 “cannot unmarshal object into go value of type []main.track” 的根本原因——json 数据结构与 go 结构体字段嵌套层级不一致，并提供精准修复方案与最佳实践。

当你使用 Go 的 encoding/json 包解析 Last.fm API（如 geo.gettoptracks）返回的 JSON 时，遇到如下错误：

json: cannot unmarshal object into Go value of type []main.Track

这并非因为字段缺失或类型错误，而是结构体定义与实际 JSON 的嵌套层级完全不匹配。

以该 API 返回的 JSON 片段为例：

{
  "tracks": {
    "track": [
      {
        "name": "Blinding Lights",
        "url": "https://www.last.fm/music/The+Weeknd/_/Blinding+Lights",
        "artist": {
          "name": "The Weeknd",
          "mbid": "99016543-4cbf-47fa-9618-929e942b1234",
          "url": "https://www.last.fm/music/The+Weeknd"
        }
      }
    ]
  }
}

注意关键点：

根对象下是 "tracks" 字段，其值是一个 object（即 JSON 对象），而非你期望的 []Track 数组；
这个 "tracks" 对象内部才包含 "track" 字段，其值才是真正的轨道数组（[]Track）。

而你原始的结构体定义为：

OpenBMB

OpenBMB是一款围绕开源大模型、工具链和端侧模型生态构建的 AI 开源社区。

下载

type Tracks struct {
    Tracks []Track // ❌ 错误：期望根对象中直接有 "tracks": [...]
}

这会让 json 包尝试将 { "track": [...] }（一个对象）强行解码为 []Track（一个切片），从而触发上述 panic。

✅ 正确做法是严格对齐 JSON 层级，定义嵌套结构体：

// 表示整个 API 响应的顶层结构
type Response struct {
    Tracks TrackList `json:"tracks"` // 对应外层 "tracks": { ... }
}

// 对应 "tracks": { "track": [...] }
type TrackList struct {
    Track []Track `json:"track"` // 注意字段名小写 + json tag 显式指定
}

type Track struct {
    Name   string `json:"name"`
    URL    string `json:"url"`
    Artist Artist `json:"artist"`
}

type Artist struct {
    Name string `json:"name"`
    MBID string `json:"mbid"`
    URL  string `json:"url"`
}

主逻辑相应调整为：

func main() {
    url := "http://ws.audioscrobbler.com/2.0/?method=geo.gettoptracks&api_key=c1572082105bd40d247836b5c1819623&format=json&country=Netherlands"
    resp, err := http.Get(url)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()

    var apiResp Response
    if err := json.NewDecoder(resp.Body).Decode(&apiResp); err != nil {
        log.Fatal("JSON decode error:", err)
    }

    for _, t := range apiResp.Tracks.Track {
        fmt.Printf("%s — %s\n", t.Artist.Name, t.Name)
    }
}

? 关键注意事项：