如何正确解析包含嵌套 JSON 数组的结构体-Golang-PHP中文网

如何正确解析包含嵌套 JSON 数组的结构体

本文详解 Go 中解析含嵌套数组的 JSON 时出现 index out of range panic 的根本原因，并提供符合 JSON 规范的结构定义与正确示例。

本文详解 go 中解析含嵌套数组的 json 时出现 `index out of range` panic 的根本原因，并提供符合 json 规范的结构定义与正确示例。

在 Go 中使用 json.Unmarshal 解析 JSON 数据时，结构体字段与 JSON 数据必须严格匹配——不仅字段名（通过 json tag 指定）要一致，数据类型和嵌套结构也必须完全对应。常见错误是误将 JSON 数组元素写成裸值（如字符串），而 Go 结构体中却定义为结构体切片，导致反序列化失败。

例如，原始代码中尝试解析如下非法 JSON：

{ "objects": [ "name": "foo" ] }

该片段语法错误：JSON 数组 [...] 内部不能直接写 "key": "value"；它必须由合法的 JSON 值组成——若需表示对象，则每个元素都必须是完整的 JSON 对象，即用花括号 {} 包裹：

✅ 正确格式：

{ "objects": [ {"name": "foo"} ] }

同时，Go 结构体定义本身是正确的：

Feishu calendar sync, local ics to json data for AI agent

将ICS日历文件转为JSON格式，用于飞书日历导入导出及数据集成。

下载

type jsonobject struct {
    Objects []ObjectType `json:"objects"`
}

type ObjectType struct {
    Name string `json:"name"`
}

但若输入 JSON 不合法或类型不匹配，json.Unmarshal 不会报错（默认静默失败），而是将 Objects 字段保持为 nil 切片。此时访问 jsontype.Objects[0] 即触发 panic: runtime error: index out of range。

✅ 正确完整示例：

package main

import (
    "fmt"
    "encoding/json"
)

type JSONObject struct {
    Objects []ObjectType `json:"objects"`
}

type ObjectType struct {
    Name string `json:"name"`
}

func main() {
    // ✅ 正确解析单个对象
    bytes1 := []byte(`{"name": "foo"}`)
    var obj ObjectType
    if err := json.Unmarshal(bytes1, &obj); err != nil {
        panic(err)
    }
    fmt.Printf("Single object: %s\n", obj.Name) // Output: foo

    // ✅ 正确解析含数组的对象（注意 JSON 中每个数组元素都是 {} 对象）
    bytes2 := []byte(`{"objects": [{"name": "foo"}, {"name": "bar"}]}`)
    var jsonObj JSONObject
    if err := json.Unmarshal(bytes2, &jsonObj); err != nil {
        panic(err)
    }

    // 安全访问：先检查长度
    if len(jsonObj.Objects) > 0 {
        fmt.Printf("First object name: %s\n", jsonObj.Objects[0].Name) // Output: foo
    } else {
        fmt.Println("No objects found")
    }
}

? 关键注意事项：