如何优雅封装 Go 中的 HTTP GET 请求与 JSON 反序列化逻辑

本文介绍一种泛型式（go 1.18 前）函数封装方案，通过接收接口类型参数实现通用 http get + json 解析逻辑复用，避免在每个 api 调用中重复编写错误处理、响应读取和反序列化代码。

在构建微服务或客户端应用时，频繁调用外部 rest api 是常见场景。若每个请求都手动编写 http.Get、状态码校验、ioutil.ReadAll（go 1.16+ 推荐 io.ReadAll）、json.Unmarshal 及层层错误检查，不仅冗余，还易引入不一致的错误处理逻辑。核心诉求很明确：将「发起 GET → 校验响应 → 读取 Body → 反序列化到任意结构体」这一固定流程抽象为一个可复用函数，仅需传入 URL 和目标数据容器即可。

关键在于理解 Go 的 json.Unmarshal 工作机制：它需要一个可寻址的指针（即能修改原值），而 Interface{} 本身是值类型容器。若你传递 users（如 []User{}），再对 &target 取地址，实际得到的是 *interface{} —— 这是一个指向接口变量的指针，而非指向 []User 底层数据的指针，因此 Unmarshal 无法正确写入目标结构。

✅ 正确做法是：直接传入目标变量的指针（&users），并在函数内将该指针作为 interface{} 透传给 json.Unmarshal：

import (     "encoding/json"     "fmt"     "io"     "net/http" )  // request 执行 GET 请求，并将响应体 JSON 反序列化到 target 指向的变量中 // target 必须为非 nil 指针（如 &users, &project） func request(url string, target interface{}) error {     resp, err := http.Get(url)     if err != nil {         return fmt.Errorf("HTTP GET failed: %w", err)     }     defer resp.Body.Close()      if resp.StatusCode != http.StatusOK {         return fmt.Errorf("HTTP %d: %s", resp.StatusCode, http.StatusText(resp.StatusCode))     }      body, err := io.ReadAll(resp.Body)     if err != nil {         return fmt.Errorf("failed to read response body: %w", err)     }      if err := json.Unmarshal(body, target); err != nil {         return fmt.Errorf("JSON unmarshal failed: %w", err)     }      return nil }

使用方式简洁清晰：

func getUsers() ([]User, error) {     var users []User     if err := request("https://api.example.com/users", &users); err != nil {         return nil, err     }     return users, nil }  func getProject(id string) (Project, error) {     var project Project     url := fmt.Sprintf("https://api.example.com/projects/%s", id)     if err := request(url, &project); err != nil {         return Project{}, err     }     return project, nil }

⚠️ 注意事项：

• target 参数必须是指向目标类型的指针（如 &users, &project），不可传值；
• 目标结构体字段需以大写字母开头并添加 json tag（如 Name stringjson:”name”`）以支持导出与解析；
• Go 1.16+ 已弃用 ioutil，请使用 io.ReadAll 替代；
• 生产环境建议增加超时控制（用 http.Client 自定义 Timeout 或 Context）；
• 如需进一步解耦，可将 request 升级为接收 *http.Client 和 context.Context 的版本，提升灵活性与可观测性。

该模式在 Go 泛型普及前被广泛采用（如 github.com/go-resty/resty/v2 底层亦遵循类似思想），它以最小侵入性达成逻辑复用，在保持类型安全的同时显著提升代码可维护性。