如何在 Go 中正确解析 JSON 数组与单个 JSON 对象_网络技术

如何在 Go 中正确解析 JSON 数组与单个 JSON 对象

发布时间 - 2026-01-31 00:00:00 点击率：次

本文详解 go 语言中解析 json 数组与单对象的常见误区，重点说明结构体定义、反序列化方式及输入格式匹配原则，并提供可运行示例与实用建议。

在 Go 中解析 JSON 时，输入 JSON 的实际结构必须与 Go 反序列化目标类型严格一致——这是绝大多数 json.Unmarshal 失败的根本原因。以问题中的数据为例：

[
  {
    "ShaId": "adf56a4d",
    "Regions": [
      { "Name": "us-east-1a" }
    ]
  }
]

这是一个 JSON 数组（[]object），因此必须使用切片（[]ShaInfo）接收；若错误地用单个结构体变量（如 var data ShaInfo）去解析该数组，json.Unmarshal 将返回 invalid character '[' looking for beginning of value 或类似错误。

✅ 正确做法：按 JSON 结构定义 Go 类型并匹配解码目标

首先定义清晰、可导出的结构体（字段首字母大写）：

type Region struct {
    Name string `json:"Name"`
}

type ShaInfo struct {
    ShaId   string  `json:"ShaId"`
    Regions []Region `json:"Regions"`
}

然后根据 JSON 输入选择对应解码

方式：

▪ 场景一：输入是 JSON 数组（推荐用于批量数据）

content := `[{"ShaId": "adf56a4d", "Regions": [{"Name": "us-east-1a"}]}]`

var results []ShaInfo
if err := json.Unmarshal([]byte(content), &results); err != nil {
    log.Fatal("解析 JSON 数组失败:", err)
}
fmt.Printf("解析成功，共 %d 条记录: %+v\n", len(results), results)
// 输出: 解析成功，共 1 条记录: [{ShaId:adf56a4d Regions:[{Name:us-east-1a}]}]

▪ 场景二：输入是单个 JSON 对象（无需方括号）

content := `{"ShaId": "adf56a4d", "Regions": [{"Name": "us-east-1a"}]}`

var single ShaInfo
if err := json.Unmarshal([]byte(content), &single); err != nil {
    log.Fatal("解析单个对象失败:", err)
}
fmt.Printf("单对象解析结果: %+v\n", single)
// 输出: 单对象解析结果: {ShaId:adf56a4d Regions:[{Name:us-east-1a}]}

⚠️ 关键注意事项

结构体字段必须导出（首字母大写）且含 json 标签，否则 json 包无法访问和赋值；
json.Unmarshal 的第二个参数必须是指针（&variable），否则无效果；
不要强行“套用”切片类型解析单对象，也不要用单结构体解析数组——Go 不会自动转换容器类型；
若上游 API 返回格式不确定（有时单对象、有时数组），可先用 json.RawMessage 做预判，或统一要求服务端返回标准数组格式（更健壮）；
使用 Go Playground 快速验证时，请确保 content 字符串与真实响应完全一致（包括空格、引号、嵌套层级）。

掌握“JSON 形态 → Go 类型 → Unmarshal 目标”三者严格对应的原则，即可彻底避免 Unable to parse JSON array 类错误。

# js # json # go # ai # golang # Array # Object # for # 字符串 # 结构体 # 指针 # var # 切片 # 对象 # 首字母 # 这是 # 也不 # 序列化 # 这是一个 # 第二个 # 要用 # 为例 # 不确定 # 先用

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：从产品到体验：慕思6.0新店态开启价值新主场

下一篇：Safari浏览器网页图片不显示怎么办_Mac浏览器图片加载

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：从产品到体验：慕思6.0新店态开启价值新主场

下一篇：Safari浏览器网页图片不显示怎么办_Mac浏览器图片加载