首页 > Golang > Go教程

Golang实现RESTAPI分页技巧

时间：2025-12-10 18:36:33 395浏览收藏

推广推荐

支持 PC / 移动端，安全直达

本篇文章向大家介绍《Golang实现REST API分页查询方法》，主要包括，具有一定的参考价值，需要的朋友可以参考一下。

答案：Golang中处理REST API分页需定义分页结构体、设置默认值并校验，通过Page和PageSize计算offset和limit构造数据库查询，使用ORM或原生SQL获取数据，同时查询总记录数，封装数据列表、总页数、当前页等信息返回标准化响应，建议限制最大页大小防止深分页，必要时采用游标分页提升性能。

如何在Golang中处理REST API分页查询

在Golang中处理REST API分页查询，核心是解析客户端传入的分页参数，构造带限制条件的数据库查询，并返回带有分页元信息的结果。关键点包括：定义分页结构体、校验和设置默认值、与数据库交互、返回标准化响应。

定义分页参数结构体

创建一个结构体来接收客户端传来的分页参数，通常包括页码和每页数量，也可支持偏移量和限制条数模式。

type Pagination struct {
Page int `json:"page"`
PageSize int `json:"page_size"`
}

在实际处理中，若未提供参数，应设置默认值，比如 page=1，page_size=10，并限制最大值防止恶意请求。

func (p *Pagination) SetDefaults() {
    if p.Page < 1 {
        p.Page = 1
    }
    if p.PageSize < 1 || p.PageSize > 100 {
        p.PageSize = 10
    }
}

构建数据库查询语句

使用计算出的 offset 和 limit 来构造 SQL 查询或 ORM 查询。以 OFFSET/LIMIT 模式为例：

offset := (p.Page - 1) * p.PageSize
query := "SELECT id, name, email FROM users LIMIT ? OFFSET ?"
rows, err := db.Query(query, p.PageSize, offset)

如果使用 GORM 等 ORM，可链式调用：

var users []User
db.Offset(offset).Limit(p.PageSize).Find(&users)

返回分页结果与元信息

除了数据列表，还应返回总记录数、当前页、每页大小等，方便前端控制翻页。

type PaginatedResponse struct {
    Data []User `json:"data"`
    Total int `json:"total"`
    Page int `json:"page"`
    PageSize int `json:"page_size"`
    Pages int `json:"pages"`
}

计算总页数：

var total int64
db.Model(&User{}).Count(&total)
pages := int(total) / p.PageSize
if int(total)%p.PageSize > 0 {
pages++
}

最终将结果封装返回：

response := PaginatedResponse{
    Data: users,
    Total: int(total),
    Page: p.Page,
    PageSize: p.PageSize,
    Pages: pages,
}
json.NewEncoder(w).Encode(response)

基本上就这些。合理封装分页逻辑，能提升API可用性和性能。注意避免深分页问题，必要时可改用游标分页（cursor-based pagination）。

终于介绍完啦！小伙伴们，这篇关于《Golang实现RESTAPI分页技巧》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布Golang相关知识，快来关注吧！