Go 如何实现未知类型HTTP响应的通用JSON反序列化

核心方案 #

完全不需要针对不同JSON格式编写分支判断逻辑，直接利用Go标准库JSON包对空接口interface{}的原生支持，就能适配任意合法JSON结构的解析需求。
json.Unmarshal在解组时如果接收变量是interface{}类型，会自动根据JSON内容的根节点类型做映射，对应规则为：

• JSON对象（{"key": value...}）自动映射为map[string]interface{}
• JSON数组（[item1, item2...]）自动映射为[]interface{}
• JSON字符串（如"ok"）自动映射为Go原生string类型
• JSON数字自动映射为Go原生float64类型
• JSON布尔值自动映射为Go原生bool类型
• JSON null自动映射为Go的nil

可直接复用的代码逻辑 #

你之前需要分三种场景编写解组逻辑的代码，完全可以合并为通用版本，适配所有JSON格式：

resp, _ := http.Post(url, "application/json", bytes.NewBuffer(jsonPayload))
defer resp.Body.Close() // 必须关闭响应体，避免长连接场景下的资源泄漏
body, _ := ioutil.ReadAll(resp.Body)

// 通用解组：不管JSON是对象、数组还是标量值，都用空接口统一接收
var genericResponse interface{}
err := json.Unmarshal(body, &genericResponse)
if err != nil {
    // 在这里处理非JSON格式的异常响应即可
}

代理场景的精度优化 #

核心风险：默认解组会把所有JSON数字转为float64类型，遇到源服务返回的大整数时容易出现精度丢失，直接影响透传结果的准确性。推荐改用json.Decoder开启UseNumber模式做解析：

decoder := json.NewDecoder(bytes.NewReader(body))
decoder.UseNumber() // 数字会以json.Number的字符串形式保留，完全无精度损失
var genericResponse interface{}
if err := decoder.Decode(&genericResponse); err != nil {
    // 非JSON响应的异常处理逻辑
}

透传业务的额外优化提示 #

作为代理类业务，核心目标是把源服务的响应无偏差透传给上游Web客户端，这里有两个可以落地的优化点：

• 解组完成后，不需要对genericResponse做任何类型断言或者格式判断，直接调用json.Marshal(genericResponse)就能把它序列化回和原始JSON结构完全一致的内容，即可透传给上游
• 如果业务逻辑完全不需要修改JSON内部的字段内容，连解组步骤都可以直接省略——把读取到的原始响应body字节流设置为上游响应的返回内容即可，能省下两次JSON序列化/反序列化的CPU开销，大幅提升代理服务的响应性能

常见误区 #

注意：不要执着于提前判断JSON根节点类型再选择对应的接收变量，这种写法本质是把静态类型的思路套用到动态格式的JSON场景上，不仅会让代码分支越来越冗余，还容易出现格式漏判。用interface{}作为接收容器，是Go语言原生支持的最低成本的通用JSON解析方案。

内容的提问来源于stack exchange，提问作者casualprogrammer