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

go 的 json.unmarshal 默认要求结构体字段类型严格匹配 json 数据类型，当同一字段有时是对象、有时是数组时，需借助 interface{} 或自定义 unmarshaljson 实现灵活解析。

go 的 json.unmarshal 默认要求结构体字段类型严格匹配 json 数据类型，当同一字段有时是对象、有时是数组时，需借助 interface{} 或自定义 unmarshaljson 实现灵活解析。

在实际对接第三方 API 时，常遇到“同一 JSON 字段类型不固定”的反模式设计：例如 line 字段在单条记录中为对象（object），而在多条记录时却变为对象数组（array）。Go 的标准 json.Unmarshal 无法直接兼容这两种形态，强行使用固定结构体（如 Line LineItem 或 Line []LineItem）会导致解码失败并返回 json.UnmarshalTypeError。

最简洁且工程友好的解决方案是延迟类型判定：先将歧义字段解码为 interface{}，再根据运行时实际类型做分支处理。以示例中的嵌套结构为例：

type Response struct {
    Net Net `json:"net"`
}

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

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

解码后，通过类型断言安全提取 line 内容：

Wjs Uploading Video

将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。

下载

func extractLines(comment map[string]interface{}) ([]LineItem, error) {
    lineRaw, ok := comment["line"]
    if !ok {
        return nil, nil // 字段不存在
    }

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

// 辅助函数：安全提取字符串字段
func getString(m map[string]interface{}, key string) string {
    if v, ok := m[key]; ok {
        if s, ok := v.(string); ok {
            return s
        }
    }
    return ""
}

⚠️ 注意事项：