Go语言中正确解析POST请求返回的JSON数组

本文详解如何在go中处理服务器返回的json数组响应，重点解决因结构体定义与json格式不匹配导致的解析错误，并提供可直接运行的代码示例和最佳实践。

本文详解如何在go中处理服务器返回的json数组响应，重点解决因结构体定义与json格式不匹配导致的解析错误，并提供可直接运行的代码示例和最佳实践。

在Go中调用http POST接口后，若服务端返回的是json数组（例如 [{“n_expediente”:”9″,”enviar”:”2″}]），而客户端仍按单个对象定义结构体并尝试反序列化，就会触发 json.Unmarshal 错误——典型表现是打印出类似 %!e(String=Array) 的非预期输出。根本原因在于：Go的json.Unmarshal要求目标变量类型必须与JSON数据结构严格一致。此处JSON为数组（[]T），但代码中声明的是单个结构体实例（ResponseFromPost{}），导致类型不匹配。

✅ 正确做法：使用切片接收JSON数组

需将目标变量声明为结构体切片（[]ResponseFromPost），而非单个结构体：

type ResponseFromPost struct {     NExpediente string `json:"n_expediente"` // 字段名匹配JSON键，且首字母大写导出     Enviar      string `json:"enviar"` }  // 解析响应体（假设 body 是 []byte 类型） var responses []ResponseFromPost if err := json.Unmarshal(body, &responses); err != nil {     log.Fatalf("JSON解析失败: %v", err) }  // 安全访问：检查切片长度后再取值 if len(responses) > 0 {     fmt.Println("发送状态:", responses[0].Enviar) }

? 关键点说明：

• 结构体字段必须首字母大写（如 NExpediente）才能被json包导出；
• 使用 json:”n_expediente” 标签显式映射JSON中的蛇形命名（snake_case）到Go的驼峰命名（camelCase）；
• 始终校验 len(responses) 避免索引越界，尤其当服务端可能返回空数组 [] 时。

? 完整可运行示例（含HTTP请求与解析）

package main  import (     "bytes"     "encoding/json"     "fmt"     "io"     "log"     "net/http" )  type ResponseFromPost struct {     NExpediente string `json:"n_expediente"`     Enviar      string `json:"enviar"` }  func main() {     // 模拟POST请求体（实际中应构造真实请求）     payload := bytes.NewBufferString(`{"key":"value"}`)      // 实际项目中替换为真实URL和client配置     resp, err := http.Post("https://httpbin.org/post", "application/json", payload)     if err != nil {         log.Fatal("请求失败:", err)     }     defer resp.Body.Close()      body, err := io.ReadAll(resp.Body)     if err != nil {         log.Fatal("读取响应体失败:", err)     }      // ✅ 正确：用切片接收JSON数组     var responses []ResponseFromPost     if err := json.Unmarshal(body, &responses); err != nil {         log.Fatal("JSON解析失败:", err)     }      // 遍历所有响应项（推荐方式）     for i, r := range responses {         fmt.Printf("第%d项 | 案件编号: %s, 发送状态: %sn", i+1, r.NExpediente, r.Enviar)     } }

⚠️ 注意事项与最佳实践

• 不要忽略错误：json.Unmarshal 失败时返回非nil错误，必须显式检查，否则后续操作可能panic；
• 避免硬编码索引：使用 for _, r := range responses 迭代更安全、更具可扩展性；
• 字段命名一致性：若API返回字段为小写字母开头（如 “n_expediente”），务必通过json标签映射，不可依赖Go字段名自动推导；
• 考虑空响应场景：服务端可能返回 [] 或 NULL，建议增加 if responses == nil 或 len(responses) == 0 判断；
• 性能提示：对大体积JSON，可考虑使用 json.Decoder 流式解析以降低内存占用。

掌握JSON数组的正确反序列化方式，是构建健壮Go HTTP客户端的基础能力。遵循结构体导出规则、精准标签映射与防御性编程习惯，即可高效、安全地处理各类API响应。

立即学习“go语言免费学习笔记（深入）”；