
本文详解如何在 go 中正确解析嵌套在顶层字段中的 json 对象数组,涵盖结构体字段命名映射、json 标签对齐、类型匹配及安全遍历技巧。
在 Go 中解析形如 { "array": [ {...}, {...} ] } 的 JSON 响应时,关键在于结构体字段名与 JSON 键名严格对应,且需通过 json 标签精准控制序列化/反序列化行为。你提供的原始代码存在两个核心问题:
- 顶层字段名不匹配:JSON 中是 "array",但结构体中却用 json:"createUserArray",导致反序列化失败,msg.CreateUser 为空切片;
- 字段映射错误:如 entity_title 应映射为 EntityTitle(而非 EntityTitleName),且 msg_body_id 是整型而非字符串,omitempty 也应作用于 int64 字段而非 string。
以下是修正后的完整可运行示例:
package main
import (
"encoding/json"
"log"
"net/http"
)
type MsgCreateUserArray struct {
CreateUser []MsgCreateUserJson `json:"array"` // ✅ 正确映射顶层 "array" 字段
}
type MsgCreateUserJson struct {
EntityTitle string `json:"entity_title"` // ✅ 原始键名直译
EntityOrgName string `json:"entity_org_name"`
PossibleUserName string `json:"possible_user_name"`
PosibbleUserEmail string `json:"posibble_user_email"` // ⚠️ 注意原始 JSON 拼写为 "posibble"
UserPositionTitle string `json:"user_position_title"`
MsgBodyID int64 `json:"msg_body_id,omitempty"` // ✅ 使用 int64 匹配 JSON 中的数字
}
func parseJson(rw http.ResponseWriter, r *http.Request) {
defer r.Body.Close() // ✅ 防止资源泄漏
var msg MsgCreateUserArray
if err := json.NewDecoder(r.Body).Decode(&msg); err != nil {
http.Error(rw, "Invalid JSON: "+err.Error(), http.StatusBadRequest)
return
}
// ✅ 安全遍历数组:检查长度避免 panic
log.Printf("Parsed %d user entries", len(msg.CreateUser))
for i, user := range msg.CreateUser {
log.Printf("[%d] %s @ %s (ID: %d)",
i+1,
user.PossibleUserName,
user.EntityTitle,
user.MsgBodyID)
}
// ✅ 此处可对每个 user 对象执行业务逻辑(如存入数据库、发送通知等)
}重要注意事项:
- 拼写一致性:原始 JSON 中 "posibble_user_email" 多了一个 b,结构体字段必须完全一致(Go 不做自动纠错);若需标准化,可在解析后手动重命名或使用自定义 UnmarshalJSON 方法;
- 类型安全:msg_body_id 是数字,应使用 int64 或 int,避免 string 导致解析失败或运行时 panic;
- 空值处理:omitempty 仅影响序列化(编码),对反序列化无影响;若字段可能缺失,建议使用指针(如 *int64)或 sql.NullInt64;
- HTTP 安全实践:务必调用 r.Body.Close(),并在错误时返回标准 HTTP 状态码(如 400 Bad Request),而非 panic。
最终,解析完成后 msg.CreateUser 即为一个标准 Go 切片,可直接用 for range 遍历、索引访问或传入其他函数处理——这才是 Go 解析 JSON 数组的标准、健壮且符合惯用法的方式。










