在调用不规范 REST API 时，常遇到同一 JSON 字段（如 "line"）在不同响应中动态表现为单个对象或对象数组，导致标准结构体反序列化失败；本文介绍通过 json.RawMessage + 类型断言或自定义 UnmarshalJSON 实现稳健、零冗余的兼容解析方案。
在调用不规范 rest api 时，常遇到同一 json 字段（如 `"line"`）在不同响应中动态表现为单个对象或对象数组，导致标准结构体反序列化失败；本文介绍通过 `json.rawmessage` + 类型断言或自定义 `unmarshaljson` 实现稳健、零冗余的兼容解析方案。
当第三方 API 对同一字段（如 net.comment.line）返回非一致类型——有时是单个 JSON 对象，有时是 JSON 数组——Go 的强类型 json.Unmarshal 会直接报错：json: cannot unmarshal object/array into Go struct field ...。硬编码两个结构体分别尝试解析不仅低效，还破坏可维护性；而盲目使用 map[string]interface{} 虽能绕过类型检查，却丧失编译期安全与字段语义，后续需大量运行时类型判断。
推荐方案：使用 json.RawMessage 延迟解析 + 自定义反序列化逻辑
json.RawMessage 是 Go 标准库提供的零拷贝字节容器，它将原始 JSON 片段暂存为 []byte，推迟解析时机，让我们能在运行时根据实际结构灵活处理：
type Line struct {
Text string `json:"$"`
Number string `json:"@number"`
}
type Comment struct {
Line json.RawMessage `json:"line"`
}
type Net struct {
Comment Comment `json:"comment"`
}
// 自定义 UnmarshalJSON 实现类型自适应
func (c *Comment) UnmarshalJSON(data []byte) error {
// 先尝试解析为单个对象
var single Line
if err := json.Unmarshal(data, &single); err == nil {
// 成功：包装为长度为 1 的切片
bytes, _ := json.Marshal([]Line{single})
c.Line = bytes
return nil
}
// 失败则尝试解析为数组
var arr []Line
if err := json.Unmarshal(data, &arr); err == nil {
bytes, _ := json.Marshal(arr)
c.Line = bytes
return nil
}
return fmt.Errorf("cannot unmarshal 'line' as object or array of objects")
}
使用时，直接解码即可获得统一的 []Line 视图：
var resp struct {
Net Net `json:"net"`
}
if err := json.Unmarshal(rawJSON, &resp); err != nil {
log.Fatal(err)
}
// 安全提取所有 line 文本（无论原始是对象还是数组）
var lines []Line
if err := json.Unmarshal(resp.Net.Comment.Line, &lines); err != nil {
log.Fatal(err)
}
for _, l := range lines {
fmt.Printf("Line %s: %s\n", l.Number, l.Text)
}
关键优势与注意事项：
✅ 类型安全：最终 lines 是明确的 []Line，支持 IDE 自动补全与编译检查；
✅ 零冗余：无需维护两套结构体，逻辑集中于 UnmarshalJSON 方法；
✅ 可扩展：可轻松扩展支持更多变体（如 null、字符串等）；
⚠️ 性能提示：json.RawMessage 避免了中间 interface{} 的反射开销，但两次 json.Marshal/Unmarshal 有轻微内存复制，对高频调用场景建议复用 bytes.Buffer 或预分配切片；
⚠️ 错误处理：生产环境应增强错误链（如用 fmt.Errorf("line: %w", err)），便于定位具体哪条响应异常。
综上，面对“JSON 类型摇摆”问题，放弃被动适配，转为主动控制解析流程——json.RawMessage 结合定制 UnmarshalJSON，是 Go 生态中最符合语言哲学、兼顾健壮性与可读性的工业级解法。
