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