本文介绍一种泛型式（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：
简单易用的 GitCode API SKILL，提供 CLI 和轻量级 Python SDK 两种调用方式，用于与 GitCode 的 REST API 进行交互。支持加密访问令牌、异步调用以及完善的类型提示。 - 文档：https://gitcode-api.readthedocs.io/ - PyPI 页面：https://pypi.org/project/gitcode-api - GitHub 仓库：https://github.com/Trenza1ore/GitCode-API
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 底层亦遵循类似思想），它以最小侵入性达成逻辑复用，在保持类型安全的同时显著提升代码可维护性。
