跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

如何在Golang中解析JSON网络数据_Golang encoding/json与http结合方法

应直接用 json.NewDecoder(resp.Body) 解析HTTP响应,避免先读取为字节切片再json.Unmarshal;需配置http.Client超时、确保结构体字段导出并正确使用json tag;解码前校验状态码和Content-Type。 直接用
json.NewDecoder
解析 HTTP 响应体,别先读成字符串再解码 很多新手会先调用
resp.Body.Read
ioutil.ReadAll
(Go 1.16+ 改用
io.ReadAll
)把响应转成
[]byte
,再传给
json.Unmarshal
。这不仅多一次内存拷贝,还可能因未关闭
Body
导致连接复用失败或内存泄漏。 正确做法是把
resp.Body
直接交给
json.NewDecoder
resp, err := http.Get("https://api.example.com/data") if err != nil { log.Fatal(err) } defer resp.Body.Close() // 必须 defer,否则连接无法复用

var data map[string]interface{} if err := json.NewDecoder(resp.Body).Decode(&data); err != nil { log.Fatal(err) }

注意:
json.NewDecoder
内部按需读取、流式解析,适合大响应;而
json.Unmarshal
要求整个 JSON 已在内存中。
http.Client
要设超时,否则默认无超时,请求可能永久挂起 Go 的
http.DefaultClient
和零值
http.Client
都没有设置超时,遇到网络卡顿、服务无响应时,
Do
会一直阻塞。生产环境必须显式配置。 立即学习 “ go语言免费学习笔记(深入) ”; 推荐方式是初始化带超时的 client:
client := &http.Client{ Timeout: 10 * time.Second, }
更精细的控制可分别设各阶段超时:
Transport.DialContext
控制建连超时
Transport.ResponseHeaderTimeout
控制收到 header 的时限
Transport.TLSHandshakeTimeout
控制 TLS 握手时间 若只设
Client.Timeout
,它覆盖的是从发起请求到读完响应体的总时间,对调试定位具体卡点帮助有限。 php版微信js-sdk支付接口类 php版微信js-sdk支付接口类 下载 结构体字段必须导出 + 正确加
json
tag,否则解析为零值 JSON 解码只能赋值到导出字段(首字母大写),且默认按字段名匹配。API 返回字段名是
user_name
,但结构体写成
UserName
就会失败——除非加 tag 显式映射:
type User struct { ID int `json:"id"` UserName string `json:"user_name"` // 必须这样,否则解不出 Email string `json:"email,omitempty"` // omitempty 表示空值不参与编码,解码不影响 }
常见错误: 字段小写(如
userName
)→ 解码跳过,保持零值 tag 拼错(如
json:"user_name "
多了个空格)→ 匹配失败 忘记导出,结构体定义在包外不可见 → 解码器根本看不到该字段 用
json:",string"
可以把数字字符串(如
"123"
)自动转成
int
,但仅限基本类型,慎用于嵌套结构。 遇到
invalid character 'N' looking for beginning of value
错误,先检查响应状态和 Content-Type 这个错误不是 JSON 格式问题,而是解码器读到了非 JSON 内容,比如:
resp.StatusCode != 200
,服务返回了 HTML 错误页(如 Nginx 502 页面,开头是
) 响应是
text/plain
text/html
,但代码仍强行用
json.Decoder
API 返回了重定向(302),但没设置
Client.CheckRedirect
,导致自动跳转后解码跳转响应体 安全做法是解码前校验:
if resp.StatusCode < 200 || resp.StatusCode >= 300 { body, _ := io.ReadAll(resp.Body) log.Printf("HTTP %d: %s", resp.StatusCode, string(body)) return } if ct := resp.Header.Get("Content-Type"); !strings.HasPrefix(ct, "application/json") { log.Printf("unexpected Content-Type: %s", ct) return }
有些 API 在错误时仍返回 200 状态码 但响应是 error JSON(如
{"error":"not found"}
),这时需要统一响应结构体或手动判断字段是否存在。 解析 JSON 网络数据的关键不在“怎么解”,而在“怎么拿到干净、可信、及时终止的响应流”。client 配置、错误分支处理、结构体定义规范,三者缺一都会让
json.Decode
成为故障放大器。

相关文章