本文介绍如何在 Go 中优雅处理结构不确定的 JSON 输入（可能是单个对象或对象数组），通过两次 json.Unmarshal 尝试 + 结构体定义，安全、高效地提取 email 字段值。
本文介绍如何在 go 中优雅处理结构不确定的 json 输入（可能是单个对象或对象数组），通过两次 `json.unmarshal` 尝试 + 结构体定义，安全、高效地提取 `email` 字段值。
在实际开发中，API 返回的 JSON 数据结构常不固定：有时返回单个对象（如 {"email": "..."}），有时返回对象数组（如 [{"email": "..."}]）。若强行用 interface{} + 类型断言处理，不仅代码冗长、易出错，还丧失类型安全与可维护性。更专业、推荐的做法是优先使用结构化类型 + 容错式反序列化。
核心思路是：先尝试将 JSON 解析为单个结构体实例；若失败（如因输入是数组而非对象），再尝试解析为结构体切片。这种方式语义清晰、性能良好，且完全避免 interface{} 带来的运行时类型风险。
以下为完整实现示例：
package main
import (
"encoding/json"
"fmt"
)
// 定义明确的数据结构，提升类型安全与可读性
type Contact struct {
Email string `json:"email"` // 注意：原始示例中 json tag 写法有误，应为 json:"email"
}
func extractEmails(data []byte) ([]string, error) {
var single Contact
var multiple []Contact
// 首先尝试解析为单个对象
if err := json.Unmarshal(data, &single); err == nil {
return []string{single.Email}, nil
}
// 若失败，尝试解析为对象数组
if err := json.Unmarshal(data, &multiple); err == nil {
emails := make([]string, len(multiple))
for i, item := range multiple {
emails[i] = item.Email
}
return emails, nil
}
return nil, fmt.Errorf("failed to unmarshal JSON as either single object or array")
}
func main() {
// 示例 1：JSON 数组
b := []byte(`[{"email":"<a class="__cf_email__" data-cfemail='\"214459404c514d4461554452550f424e4c\"' href="%5C%22/cdn-cgi/l/email-protection%5C%22">[email protected]</a>"}]`)
// 示例 2：JSON 对象
c := []byte(`{"email":"<a class="__cf_email__" data-cfemail='\"7f1a071e120f131a3f0b1a0c0b511c1012\"' href="%5C%22/cdn-cgi/l/email-protection%5C%22">[email protected]</a>"}`)
// 统一处理逻辑
if emails, err := extractEmails(b); err == nil {
fmt.Println("From array:", emails)
}
if emails, err := extractEmails(c); err == nil {
fmt.Println("From object:", emails)
}
}
✅ 关键要点说明：
- json:"email" 是正确的 struct tag 写法（原始答案中误写为 json:email，会导致字段无法正确映射）；
- 使用具名结构体（Contact）替代 interface{}，获得编译期检查、IDE 支持和清晰语义；
- extractEmails 函数封装了容错逻辑，返回 []string 统一结果，调用方无需关心底层结构差异；
- 错误处理明确：两次 Unmarshal 均失败时抛出有意义的错误，便于调试与监控。
⚠️ 注意事项：
- 不建议对同一字节切片反复调用 json.Unmarshal（虽 Go 的 json 包支持，但存在轻微性能开销）；若需极致性能且数据量极大，可先用 json.RawMessage 预判首字符（[ 或 {）再分支解析；
- 若 JSON 结构更复杂（如嵌套混合数组/对象），可结合 json.RawMessage 或自定义 UnmarshalJSON 方法实现精细控制；
- 生产环境建议配合 json.Compact 或日志记录原始输入，便于排查解析异常。
通过这种结构化 + 渐进式解析的方式，你既能稳健应对多变的 JSON 格式，又能保持 Go 代码的简洁性、可读性与工程健壮性。
