
本文详解 go 语言中发起 http 请求、读取响应体并安全解析 json 的完整流程,涵盖错误处理、资源释放和结构化解析等关键实践。
在 Go 中,http.Get() 仅返回 *http.Response 结构体(包含 状态码 、Header 等元信息), 并不会自动读取或解析响应体内容。你看到的 &{200 OK …} 输出正是 resp 变量本身的指针打印结果,而非 JSON 数据——真正的 JSON 内容位于 resp.Body 这个 io.ReadCloser 流中,必须显式读取并解码。
以下是修正后的标准实践代码(已补充必要导入和完整示例):
package main import ("encoding/json" "fmt" "io" "net/http") func getDuckDuckGo(keyword string) (map[string]interface{}, error) {// 1. 发起请求并检查错误 resp, err := http.Get("https://api.duckduckgo.com/?q=" + keyword + "&format=json&no_html=1") if err != nil {return nil, fmt.Errorf("HTTP request failed: %w", err) } defer resp.Body.Close() // 2. 必须关闭响应体,防止连接泄漏 // 3. 检查 HTTP 状态码 if resp.StatusCode != http.StatusOK { return nil, fmt.Errorf("API returned non-200 status: %d", resp.StatusCode) } // 4. 使用 json.Decoder 直接从 Body 解码(流式、内存友好)var result map[string]interface{} if err := json.NewDecoder(resp.Body).Decode(&result); err != nil {return nil, fmt.Errorf("JSON decode failed: %w", err) } return result, nil } func main() { data, err := getDuckDuckGo("food") if err != nil {panic(err) } // 示例:安全提取字段(注意类型断言)if definition, ok := data["AbstractText"].(string); ok && definition != ""{fmt.Println("Definition:", definition) } else {fmt.Println("No definition found.") } if results, ok := data["RelatedTopics"].([]interface{}); ok && len(results) > 0 {if first, ok := results[0].(map[string]interface{}); ok {if firstText, ok := first["Text"].(string); ok {fmt.Println("First related topic:", firstText) } } } }
⚠️ 关键注意事项:
- 永远检查 http.Get() 和 json.Decode() 的错误:忽略错误是 Go 程序崩溃或静默失败的主因;
- 务必调用 resp.Body.Close():即使使用 defer,也应在 if err != nil 后立即 return,避免执行到 defer 前 panic;
- 优先使用 json.Decoder 而非 json.Unmarshal(io.ReadAll(…)):前者支持流式解析,对大响应更省内存;
- DuckDuckGo API 已弃用 HTTP(需改用 HTTPS),且建议添加 &no_html=1 避免 HTML 转义干扰;
- 若需强类型保障,应定义结构体(如 type DuckDuckResponse struct {AbstractText stringjson:”AbstractText”}),而非泛型 map[string]interface{}。
掌握这一模式,即可稳健处理任意 RESTful JSON API,为构建 爬虫、微服务客户端等打下坚实基础。