JSON数组解析失败：Go结构体嵌套数组时的常见错误与修复方案-Golang-PHP中文网

JSON数组解析失败：Go结构体嵌套数组时的常见错误与修复方案

本文详解go语言中解析含嵌套json数组时因json格式不匹配导致的“index out of range”运行时错误，并提供正确结构定义、合法json示例及健壮性处理建议。

本文详解go语言中解析含嵌套json数组时因json格式不匹配导致的“index out of range”运行时错误，并提供正确结构定义、合法json示例及健壮性处理建议。

在Go中使用encoding/json解析JSON时，结构体字段与JSON数据必须严格匹配——不仅字段名（通过json标签）需一致，数据类型和嵌套结构也必须完全对应。上述代码报错的根本原因在于：JSON字符串 { "objects": [ "name": "foo" ] } 语法非法，且即使修正语法，其内容仍与Go结构体[]ObjectType不兼容。

首先，该JSON存在两处严重问题：

JSON语法错误：[ "name": "foo" ] 不是合法JSON——数组元素不能直接写键值对；正确写法应为对象字面量 {"name": "foo"}；
类型不匹配：ObjectType 是结构体，要求JSON中对应数组元素必须是对象（object），而非字符串、数字等基础类型。

✅ 正确的JSON输入应为：

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

同时，Go结构体定义本身合理，但需注意：

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

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

下载

Objects 字段为切片，若JSON中"objects"缺失或为空数组，jsontype.Objects将为nil或空切片，直接访问[0]必然panic；
建议始终校验切片长度或使用安全索引。

以下是修复后的完整可运行示例：

package main

import (
    "fmt"
    "encoding/json"
)

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

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

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

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

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

    // ? 额外提示：若JSON中"objects"字段可能不存在或为null，
    // 可将字段声明为指针或使用omitempty + 零值判断增强鲁棒性
}

⚠️ 关键注意事项：