如何在 Go 中正确发起 HTTP GET 请求并解析 JSON 响应

9次阅读

如何在 Go 中正确发起 HTTP GET 请求并解析 JSON 响应

本文详解 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,为构建 爬虫、微服务客户端等打下坚实基础。

星耀云
版权声明:本站原创文章,由 星耀云 2026-01-01发表,共计1726字。
转载说明:转载本网站任何内容,请按照转载方式正确书写本站原文地址。本站提供的一切软件、教程和内容信息仅限用于学习和研究目的;不得将上述内容用于商业或者非法用途,否则,一切后果请用户自负。本站信息来自网络,版权争议与本站无关。
text=ZqhQzanResources