本文介绍一种简洁、类型安全的 go 通用 http get 封装方法，通过传入指针参数实现任意结构体/切片的自动反序列化，彻底消除重复的错误检查、响应读取和 json.unmarshal 模板代码。
在构建高 API 密度的 Go 应用时，大量重复的 HTTP 客户端逻辑（GET → 状态校验 → 读体 → JSON 解析 → 错误处理）不仅冗长易错，还严重阻碍可维护性。核心痛点在于：业务差异仅在于目标数据类型，但标准 json.Unmarshal 要求传入指向目标值的指针——而若在泛型函数中错误地对 interface{} 取地址（如 &target），实际得到的是 *interface{}，而非 *[]User 或 *Project，导致反序列化失败。
✅ 正确解法是：直接将已取好地址的接口值（即 *[]User、*Project）传入泛型函数，并原样传递给 json.Unmarshal。Go 的 interface{} 可容纳任意具体类型的指针，且 json.Unmarshal 内部能正确识别其底层指针语义。
以下是推荐的生产就绪封装：
import (
"encoding/json"
"io"
"net/http"
"time"
)
// RequestJSON 执行 GET 请求，读取响应体并反序列化到 target 指向的变量中
// target 必须为非 nil 指针（如 &users, &project）
func RequestJSON(url string, target interface{}) error {
// 可选：配置超时、自定义 client
client := &http.Client{
Timeout: 10 * time.Second,
}
resp, err := client.Get(url)
if err != nil {
return 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("failed to unmarshal JSON: %w", err)
}
return nil
}使用方式清晰直观：
// 获取用户列表
var users []User
if err := RequestJSON("https://api.example.com/users", &users); err != nil {
log.Fatal(err)
}
fmt.Printf("Fetched %d users\n", len(users))
// 获取单个项目
var project Project
if err := RequestJSON("https://api.example.com/projects/123", &project); err != nil {
log.Fatal(err)
}⚠️ 关键注意事项：
- 必须传指针：&users 而非 users，否则 json.Unmarshal 无法修改原始变量；
- 避免 ioutil.ReadAll：Go 1.16+ 推荐使用 io.ReadAll（ioutil 已弃用）；
- 错误链增强：使用 %w 格式化包装底层错误，便于 errors.Is/As 判断；
- 可扩展性：后续可轻松支持 POST、请求头、认证 Token、重试机制等，均不破坏现有调用契约。
该模式兼顾类型安全与复用性，无需依赖泛型（兼容 Go 1.18 之前版本），是 Go 生态中被广泛验证的 HTTP 客户端抽象范式。
