如何优雅处理 JSON 中字段类型不一致（时而对象、时而数组）的问题-Golang-PHP中文网

如何优雅处理 JSON 中字段类型不一致（时而对象、时而数组）的问题

Go 语言中解析结构不固定的 JSON 时，若某字段可能为单个对象或对象数组，直接使用固定结构体将导致 Unmarshal 失败；推荐采用 json.RawMessage 或 interface{} + 类型断言的组合策略，兼顾灵活性与类型安全。

go 语言中解析结构不固定的 json 时，若某字段可能为单个对象或对象数组，直接使用固定结构体将导致 unmarshal 失败；推荐采用 `json.rawmessage` 或 `interface{}` + 类型断言的组合策略，兼顾灵活性与类型安全。

在实际对接第三方 API 时，常会遇到字段类型“飘忽不定”的情况——例如 line 字段在响应中有时是单个 JSON 对象（如 {"$": "xxx", "@number": "0"}），有时却是对象数组（如 [{"$": "xxx", "@number": "0"}, {"$": "yyy", "@number": "1"}]）。这种设计虽不符合严格 Schema 规范，但在遗留系统或松散定义的 API 中十分常见。硬编码两种结构体并尝试双重解码不仅冗余，还易引入逻辑漏洞。

推荐方案：使用 json.RawMessage 延迟解析
json.RawMessage 是 Go 标准库提供的零拷贝字节容器，可暂存未解析的 JSON 片段，待运行时根据实际结构再决定如何处理：

chartjs-reporter

此技能用于在用户需要将结构化数据（查询结果、CSV 摘要、JSON 记录或 Python 字典/列表）转换为独立的 HTML 页面时使用。

下载

type LineItem struct {
    Text   string `json:"$"`
    Number string `json:"@number"`
}

type Net struct {
    Comment struct {
        Line json.RawMessage `json:"line"`
    } `json:"comment"`
}

func (n *Net) GetLines() ([]LineItem, error) {
    if len(n.Comment.Line) == 0 {
        return []LineItem{}, nil
    }

    // 先尝试解析为单个对象
    var single LineItem
    if err := json.Unmarshal(n.Comment.Line, &single); err == nil {
        return []LineItem{single}, nil
    }

    // 失败则尝试解析为数组
    var arr []LineItem
    if err := json.Unmarshal(n.Comment.Line, &arr); err == nil {
        return arr, nil
    }

    return nil, fmt.Errorf("failed to unmarshal 'line' as object or array")
}

替代方案：用 interface{} + 类型断言（适合简单场景）
若无需强类型校验或结构较浅，也可先解到 map[string]interface{} 或 interface{}，再动态判断：

type NetV2 struct {
    Comment map[string]interface{} `json:"comment"`
}

func (n *NetV2) GetLines() ([]LineItem, error) {
    lineRaw, ok := n.Comment["line"]
    if !ok {
        return []LineItem{}, nil
    }

    switch v := lineRaw.(type) {
    case map[string]interface{}:
        // 单个对象 → 转为 LineItem
        item := LineItem{
            Text:   toString(v["$"]),
            Number: toString(v["@number"]),
        }
        return []LineItem{item}, nil
    case []interface{}:
        // 数组 → 遍历转为 []LineItem
        var result []LineItem
        for _, i := range v {
            if m, ok := i.(map[string]interface{}); ok {
                result = append(result, LineItem{
                    Text:   toString(m["$"]),
                    Number: toString(m["@number"]),
                })
            }
        }
        return result, nil
    default:
        return nil, fmt.Errorf("unexpected type for 'line': %T", v)
    }
}

func toString(v interface{}) string {
    if s, ok := v.(string); ok {
        return s
    }
    return ""
}

✅ 关键注意事项：