本文介绍如何在 Go 中优雅地处理“可能为 JSON 对象、也可能为 JSON 数组”的动态结构，通过两次 json.Unmarshal 尝试 + 结构体定义，安全提取 email 字段值，避免 interface{} 类型断言的冗余与风险。
本文介绍如何在 go 中优雅地处理“可能为 json 对象、也可能为 json 数组”的动态结构，通过两次 `json.unmarshal` 尝试 + 结构体定义，安全提取 `email` 字段值，避免 `interface{}` 类型断言的冗余与风险。
在实际开发中（如 API 响应、第三方 Webhook 或配置文件解析），我们常遇到 JSON 格式不固定的情况：同一字段名 email 可能嵌套在单个对象中（{"email": "..."}），也可能出现在对象数组中（[{"email": "..."}, {"email": "..."}]）。若强行用 interface{} + 类型断言处理，不仅代码冗长、易出错，还难以保证类型安全和可维护性。
推荐做法是优先尝试结构化解码，而非泛型 interface{}。核心思路是：定义清晰的数据模型（如 Item 结构体），然后按需尝试两种解码目标——单个对象指针或对象切片指针，并根据错误结果决定后续逻辑。
以下是一个生产就绪的完整示例：
package main
import (
"encoding/json"
"fmt"
)
type Item struct {
Email string `json:"email"` // 注意：json tag 必须为小写 "email"，原答案中误写为 `json:email`
}
func extractEmails(data []byte) ([]string, error) {
var single Item
var slice []Item
// 先尝试解码为单个对象
if err := json.Unmarshal(data, &single); err == nil {
return []string{single.Email}, nil
}
// 若失败，再尝试解码为对象数组
if err := json.Unmarshal(data, &slice); err == nil {
emails := make([]string, len(slice))
for i, item := range slice {
emails[i] = item.Email
}
return emails, nil
}
return nil, fmt.Errorf("failed to unmarshal JSON as either object or array of objects")
}
func main() {
// 情况1：JSON 数组
b := []byte(`[{"email":"<a class="__cf_email__" data-cfemail="13766b727e637f764c7a7d4c726161726a53677660673d707c7e" href="/cdn-cgi/l/email-protection">[email protected]</a>"}]`)
// 情况2：JSON 对象
c := []byte(`{"email":"<a class="__cf_email__" data-cfemail="c7a2bfa6aab7aba287b3a2b4b3e9a4a8aa" href="/cdn-cgi/l/email-protection">[email protected]</a>"}`)
if emails, err := extractEmails(b); err == nil {
fmt.Printf("Array input → %v\n", emails)
}
if emails, err := extractEmails(c); err == nil {
fmt.Printf("Object input → %v\n", emails)
}
}
✅ 关键要点说明：
- json:"email" tag 必须正确书写（冒号后加双引号），否则字段无法被反序列化；
- 使用 []Item（而非 []*Item）更简洁且无内存泄漏风险，除非需区分 nil 字段；
- 将解码逻辑封装为 extractEmails() 函数，提升复用性与测试友好性；
- 错误处理明确：仅当两种解码均失败时才返回错误，避免静默忽略异常；
- 不依赖 reflect 或运行时类型判断，性能更高、意图更清晰。
⚠️ 注意事项：
- 若 JSON 中存在其他字段，结构体应补充对应字段或使用 json:",omitempty" 控制；
- 对于深层嵌套或更复杂变体（如混合对象/数组、带元数据 wrapper），建议引入中间结构体（如 Wrapper{Data interface{}}）或使用 json.RawMessage 延迟解析；
- 生产环境建议配合 json.Compact() 或日志记录原始数据，便于排查格式异常。
该方案兼顾安全性、可读性与工程实践，是处理“弹性 JSON 结构”的 Go 标准范式之一。
