本文介绍如何在 go 语言中不依赖泛型（go 1.18 前）或反射，通过接口定义 + 匿名字段嵌入，优雅复用分页逻辑，避免为每种资源类型（如 loan、lender）重复编写几乎相同的分页请求与解析代码。
本文介绍如何在 go 语言中不依赖泛型（go 1.18 前）或反射，通过接口定义 + 匿名字段嵌入，优雅复用分页逻辑，避免为每种资源类型（如 loan、lender）重复编写几乎相同的分页请求与解析代码。
在构建 REST API 客户端（例如 Kiva API 封装）时，常见模式是多个端点返回结构高度相似的分页响应：均含统一的 paging 元信息（总条数、当前页、页大小、总页数）和一个泛型化的 items 数组（如 []Loan 或 []Lender）。若为每个类型单独实现分页拉取逻辑，将导致大量重复代码——这不仅违背 DRY 原则，也显著增加维护成本。
Go 虽在 1.18 后支持泛型，但即使在旧版本中，我们也能借助接口抽象 + 结构体嵌入实现类型安全、零反射的复用方案。
✅ 核心思路：定义可分页接口 + 统一分页器结构
首先，定义一个轻量接口，仅声明获取分页元数据的能力：
type Pagable interface {
Paging() PagingData
}接着，创建一个通用的 Pager 结构体，负责承载并暴露分页字段：
type Pager struct {
Paging PagingData `json:"paging"`
}
func (p Pager) Paging() PagingData {
return p.Paging
}关键在于：让所有分页响应类型匿名嵌入 Pager。Go 的嵌入机制会自动将 Pager 的字段和方法“提升”到外层结构体中，使其天然满足 Pagable 接口：
type PagedLoanResponse struct {
Pager // ← 嵌入：获得 Paging() 方法 + paging 字段
Items []Loan `json:"loans"`
}
type PagedLenderResponse struct {
Pager // ← 同样嵌入
Items []Lender `json:"lenders"`
}此时，PagedLoanResponse 和 PagedLenderResponse 都实现了 Pagable 接口，且 JSON 反序列化时能正确填充 paging 和 items 字段（json 标签仍生效）。
✅ 改写 doPaged：接收接口，消除反射
现在可重写 doPaged 方法，签名更清晰、类型安全、无需 reflect：
func (c *Client) doPaged(
method, urlpath string,
query url.Values,
body io.Reader,
v Pagable, // ← 接收接口，而非 interface{}
numPages int,
) (interface{}, error) {
if numPages < 0 {
return nil, fmt.Errorf("numPages must be non-negative")
}
// 创建目标类型的指针（v 是值，需传 &v 给 json.Unmarshal）
vPtr := reflect.New(reflect.TypeOf(v).Elem()).Interface()
// 第一页请求
if query == nil {
query = url.Values{}
}
if err := c.do(method, urlpath, query, body, vPtr); err != nil {
return nil, err
}
// 断言为 Pagable 并获取分页信息
pagable, ok := vPtr.(Pagable)
if !ok {
return nil, fmt.Errorf("response type does not implement Pagable")
}
paging := pagable.Paging()
if paging.Pages == 1 {
// 提取 items 字段（需反射，因 items 名称/类型各异）
itemsField := reflect.ValueOf(vPtr).Elem().FieldByName("Items")
if !itemsField.IsValid() {
return nil, fmt.Errorf("missing 'Items' field in response struct")
}
return itemsField.Interface(), nil
}
if numPages == 0 {
numPages = paging.Pages
}
// 初始化结果切片（需动态确定 items 元素类型）
itemsValue := reflect.ValueOf(vPtr).Elem().FieldByName("Items")
itemType := itemsValue.Type().Elem()
resultSlice := reflect.MakeSlice(reflect.SliceOf(itemType), 0, paging.Total)
// 拉取第 1 页（已获取）→ 追加
resultSlice = reflect.AppendSlice(resultSlice, itemsValue)
// 拉取后续页面
for i := 2; i <= numPages; i++ {
query.Set("page", strconv.Itoa(i))
if err := c.do("GET", urlpath, query, nil, vPtr); err != nil {
return nil, err
}
itemsValue = reflect.ValueOf(vPtr).Elem().FieldByName("Items")
resultSlice = reflect.AppendSlice(resultSlice, itemsValue)
}
return resultSlice.Interface(), nil
}⚠️ 注意：虽然
v是接口，但Items字段名固定，因此只需一次反射提取其值；相比原方案全程反射操作pr，此处反射范围极小，且完全可控。
✅ 使用示例：简洁、类型安全
func (c *Client) GetNewestLoans(numPages int) ([]Loan, error) {
baseURL := "/v1/loans/newest"
var resp PagedLoanResponse
items, err := c.doPaged("GET", baseURL, nil, nil, &resp, numPages)
if err != nil {
return nil, err
}
return items.([]Loan), nil // 类型断言明确，编译期可检
}
func (c *Client) GetTopLenders(numPages int) ([]Lender, error) {
baseURL := "/v1/lenders/top"
var resp PagedLenderResponse
items, err := c.doPaged("GET", baseURL, nil, nil, &resp, numPages)
if err != nil {
return nil, err
}
return items.([]Lender), nil
}✅ 总结与优势
-
零反射开销（主逻辑）：分页控制流完全基于接口，仅
Items提取需最小化反射，性能与可读性兼顾； - 强类型保障：调用方传入具体结构体指针，返回值经明确断言，IDE 和编译器可提供完整支持；
-
易于扩展：新增分页类型只需嵌入
Pager并定义Items字段，无需修改doPaged； - 符合 Go 习惯：利用嵌入（embedding）和接口（interface）两大核心机制，而非强行模拟泛型。
该方案在 Go 泛型普及前已被广泛验证（如 Kubernetes client-go 的 ListOptions 模式），是处理同构分页响应的经典实践。
