如何在 Go 中正确解析 JSON 数组中的嵌套对象-Golang-PHP中文网

如何在 Go 中正确解析 JSON 数组中的嵌套对象

本文详解如何使用 Go 的 encoding/json 包安全、高效地解析包含多个嵌套 JSON 对象的数组，重点解决结构体字段导出、嵌套结构定义及批量提取字段等常见问题。

本文详解如何使用 go 的 `encoding/json` 包安全、高效地解析包含多个嵌套 json 对象的数组，重点解决结构体字段导出、嵌套结构定义及批量提取字段等常见问题。

在 Go 中解析 JSON 数组（如 API 返回的客户端列表），关键在于结构体定义必须与 JSON 数据严格匹配，且所有需反序列化的字段必须是首字母大写的导出字段。你提供的代码中存在两个核心问题：keepalive 字段未导出（小写开头）且类型错误（声明为 []string，实际是嵌套对象），这将导致该字段始终为零值，甚至引发静默解析失败。

首先，修正结构体定义。根据示例 JSON，keepalive 是一个包含 thresholds、handlers 和 refresh 的复合对象，需定义为独立结构体：

type Thresholds struct {
    Warning  int `json:"warning"`
    Critical int `json:"critical"`
}

type Keepalive struct {
    Thresholds Thresholds `json:"thresholds"`
    Handlers   []string   `json:"handlers"`
    Refresh    int        `json:"refresh"`
}

type Client struct {
    Name        string     `json:"name"`
    Address     string     `json:"address"`
    PublicDNS   string     `json:"publicDNS"` // 注意：原始 JSON 中无此字段，若 API 不返回则反序列化为空
    Keepalive   Keepalive  `json:"keepalive"`   // ✅ 首字母大写 + 正确类型
    Subscriptions []string `json:"subscriptions"`
    Version       string   `json:"version"`
    Timestamp     int64    `json:"timestamp"`
}

// 使用切片类型更直观，无需自定义别名
type ClientResponse []Client

接着，优化解析函数，避免不必要的指针操作和错误忽略：

func getClients(body []byte) (ClientResponse, error) {
    var clients ClientResponse
    if err := json.Unmarshal(body, &clients); err != nil {
        return nil, fmt.Errorf("failed to unmarshal clients: %w", err)
    }
    return clients, nil
}

调用时，直接遍历切片获取所需字段——这是 Go 中处理此类场景的标准且高效方式（无需额外抽象）：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

clients, err := getClients(body)
if err != nil {
    log.Fatal(err)
}

// 提取所有 name 字段
var names []string
for _, c := range clients {
    names = append(names, c.Name)
}
fmt.Println("All names:", names)

// 或使用预分配提升性能（当长度已知时）
names = make([]string, len(clients))
for i, c := range clients {
    names[i] = c.Name
}

⚠️ 注意事项：