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