如何正确解析包含多个 JSON 对象的 JSON 数组

本文详解如何在 go 中准确解析嵌套在顶层字段中的 json 对象数组，包括结构体字段名与 json 键的精确映射、类型匹配（如 `int64` vs `String`）、以及安全遍历解析后数据的完整实践。

在 go 中解析 jsON 数组时，常见错误往往源于结构体字段标签（Struct tags）与实际 json 键名不一致，或数据类型声明不匹配（例如将数字型 ID 声明为 string）。以你提供的示例为例，原始 JSON 的顶层字段是 “Array”，而非 “createUserArray”；且每个对象中键名为 “entity_title”，但结构体却误写为 “entity_title_name” —— 这会导致解码失败或字段为空。

首先，修正结构体定义，确保 json 标签严格对应 JSON 字段名，并选用合适的数据类型：

type MsgCreateUserArray struct {     CreateUser []MsgCreateUserJson `json:"array"` // ✅ 匹配 JSON 中的 "array" 字段 }  type MsgCreateUserJson struct {     EntityTitle       string  `json:"entity_title"`        // ✅ 原始键名，非 entity_title_name     EntityOrgName     string  `json:"entity_org_name"`     PossibleUserName  string  `json:"possible_user_name"`     PosibbleUserEmail string  `json:"posibble_user_email"`   // ⚠️ 注意：JSON 中拼写为 "posibble"（疑似 typo，需按实际保留）     UserPositionTitle string  `json:"user_position_title"`     MsgBodyID         int64   `json:"msg_body_id,omitempty"` // ✅ msg_body_id 是整数，用 int64 更安全（避免溢出） }

? 关键修正点说明：json:”array” → 正确绑定顶层数组字段；字段名 EntityTitle 对应 “entity_title”，而非 “entity_title_name”；MsgBodyID 使用 int64 并添加 omitempty（因 JSON 中该值无小数，且 omitempty 在零值时可忽略序列化，不影响解析）；拼写差异（如 “posibble_user_email”）必须如实反映在 tag 中——Go 解析器严格区分大小写与拼写。

接下来，在 http 处理函数中完成解析与遍历：

func parseJson(rw http.ResponseWriter, request *http.Request) {     defer request.Body.Close() // ✅ 防止资源泄漏      decoder := json.NewDecoder(request.Body)     var payload MsgCreateUserArray      if err := decoder.Decode(&payload); err != nil {         http.Error(rw, "Invalid JSON: "+err.Error(), http.StatusbadRequest)         return     }      // ✅ 安全遍历解析后的对象切片     for i, user := range payload.CreateUser {         log.Printf("Item %d: %s @ %s, position: %s, ID: %d",             i+1,             user.PossibleUserName,             user.EntityTitle,             user.UserPositionTitle,             user.MsgBodyID,         )         // 此处可对每个 user 执行业务逻辑：存入 DB、校验邮箱、触发通知等     }      rw.WriteHeader(http.StatusOK)     rw.Write([]byte("OK")) }

? 注意事项与最佳实践：

• 始终调用 request.Body.Close()（建议用 defer），避免连接复用时的潜在问题；
• 使用 http.Error() 返回清晰的客户端错误，而非 panic —— 生产环境应避免 panic 中断服务；
• 若 msg_body_id 可能缺失，omitempty 仅影响序列化；解析时若字段不存在，int64 将默认为 0，必要时可改用 *int64 表示可空；
• html 转义邮箱（如 [email protected]）属于前端防护（Cloudflare Email Protection），后端解析得到的是完整 HTML 字符串；如需提取纯邮箱，应使用 html.UnescapeString() 或正则清洗，切勿直接渲染到页面以防 xss。

通过以上结构体修正 + 类型对齐 + 安全遍历，你即可稳健地从 HTTP 请求中提取并处理任意长度的 JSON 对象数组。