如何在 Go 中优雅处理 JSON 中“单个元素或数组”混合结构-Golang-PHP中文网

如何在 Go 中优雅处理 JSON 中“单个元素或数组”混合结构

本文介绍在 Go 中处理 JSON 数据中同一字段可能为单个对象或对象数组的常见场景，提供基于 json.RawMessage 和前缀判断的惯用解决方案，并附带完整示例与关键注意事项。

本文介绍在 go 中处理 json 数据中同一字段可能为单个对象或对象数组的常见场景，提供基于 `json.rawmessage` 和前缀判断的惯用解决方案，并附带完整示例与关键注意事项。

在实际 API 开发中，尤其是对接历史遗留或第三方前端系统时，常会遇到 JSON 字段 data 的类型不一致问题：它可能是一个对象（如 {"id": 1}），也可能是一个对象数组（如 [{"id": 1}, {"id": 2}]）。由于客户端无法修改，服务端必须兼容这两种格式。Go 的强类型特性使得直接定义统一结构体变得困难，但通过合理利用 json.RawMessage 和轻量级类型探测，可实现简洁、高效且符合 Go 惯用法的解析逻辑。

核心思路是：延迟解析 + 前缀预判。先将原始 JSON 字段保留为 json.RawMessage，再根据其首字符（{ 表示对象，[ 表示数组）决定后续反序列化路径，最终统一归一化为切片（[]*Data），避免运行时频繁类型检查，提升代码可读性与维护性。

以下为推荐实现：

jm-jsjkxyjs02-pzl-803

查询全球任意城市的实时天气和未来天气预报

下载

type Data struct {
    ID int `json:"id"`
}

type Request struct {
    RawData json.RawMessage `json:"data"` // 导出字段，供 json.Unmarshal 自动填充
    DataList []*Data         `json:"-"`    // 内部字段，始终以切片形式使用
}

func (r *Request) ParseData() error {
    raw := bytes.TrimSpace(r.RawData)
    if len(raw) == 0 {
        return errors.New("empty data field")
    }

    switch raw[0] {
    case '{':
        var single Data
        if err := json.Unmarshal(r.RawData, &single); err != nil {
            return fmt.Errorf("failed to unmarshal single data: %w", err)
        }
        r.DataList = []*Data{&single}
    case '[':
        if err := json.Unmarshal(r.RawData, &r.DataList); err != nil {
            return fmt.Errorf("failed to unmarshal data array: %w", err)
        }
    default:
        return errors.New("invalid JSON value in 'data': expected object or array")
    }
    return nil
}

使用时只需调用 ParseData() 即可完成标准化转换：

var req Request
if err := json.Unmarshal(payload, &req); err != nil {
    log.Fatal(err)
}
if err := req.ParseData(); err != nil {
    log.Fatal(err)
}
// 此后始终通过 req.DataList 安全访问，无需条件分支
for _, d := range req.DataList {
    fmt.Printf("ID: %d\n", d.ID)
}

⚠️ 注意事项：