在 Go 开发中，当第三方 API（如 Yahoo Finance）对同一字段返回单个对象或对象数组时，可通过自定义 UnmarshalJSON 方法实现零冗余结构体的统一解析。
在 go 开发中，当第三方 api（如 yahoo finance）对同一字段返回单个对象或对象数组时，可通过自定义 `unmarshaljson` 方法实现零冗余结构体的统一解析。
在实际 Web 服务开发中，尤其对接金融类 REST API 时，常遇到「同一字段名 quote 在单条查询时为对象、多条查询时为数组」的不一致响应格式。Go 的 encoding/json 默认不支持自动类型推断，若强行用 []StockQuote 解析单对象会报错，用 StockQuote 解析数组也会失败——此时无需定义两套结构体，而是通过实现 UnmarshalJSON 接口，主动控制反序列化逻辑。
核心思路是：定义一个中间包装类型（如 structOrArray），在 UnmarshalJSON 中先探测 JSON Token 类型（[ 表示数组，{ 表示对象），再分别解码到对应字段：
type structOrArray struct {
parent *Quote
s StockQuote
a []StockQuote
}
func (s *structOrArray) UnmarshalJSON(data []byte) error {
d := json.NewDecoder(bytes.NewBuffer(data))
tok, err := d.Token()
if err != nil {
return err
}
switch tok {
case json.Delim('['):
return json.Unmarshal(data, &s.a)
case json.Delim('{'):
return json.Unmarshal(data, &s.s)
default:
return fmt.Errorf("unexpected JSON token: %v", tok)
}
}
接着，让目标结构体 Quote 实现 UnmarshalJSON，将解析结果桥接到两个字段中：
type Quote struct {
Quote *StockQuote // 单对象引用（非 nil 时有效）
Quotes []StockQuote // 数组（len > 0 时有效）
}
func (q *Quote) UnmarshalJSON(data []byte) error {
var wrapper struct {
Quote structOrArray `json:"quote"`
}
if err := json.Unmarshal(data, &wrapper); err != nil {
return err
}
// 优先设置单对象（若存在）
if !reflect.DeepEqual(wrapper.Quote.s, StockQuote{}) {
q.Quote = &wrapper.Quote.s
}
// 同时设置数组（若非空）
if len(wrapper.Quote.a) > 0 {
q.Quotes = wrapper.Quote.a
}
return nil
}
使用时保持原有结构体嵌套不变，json.Unmarshal 会自动调用自定义逻辑：
var result QueryResult json.Unmarshal(data, &result) // 统一访问：result.Query.Results.Quote 或 result.Query.Results.Quotes
✅ 优势总结：
- 零重复结构体定义，避免维护成本；
- 兼容性透明，业务层无需判断数据形态；
- 可扩展性强，后续新增字段无需修改反序列化逻辑；
- 符合 Go 的接口驱动设计哲学，清晰表达意图。
⚠️ 注意事项：
- StockQuote 字段需确保零值可区分（如字符串字段默认为空而非 "null"），否则单对象解码后无法与默认零值区分；建议在 UnmarshalJSON 中增加字段有效性校验（如检查 Symbol 是否非空）；
- 若 API 可能返回 null，需额外处理 json.RawMessage 或添加 *StockQuote 判断；
- 生产环境建议配合单元测试覆盖单/多/空三种响应场景。
