如何在Golang中实现分页功能-Golang-PHP中文网

如何在Golang中实现分页功能

P粉602998670

发布： 2025-10-01 14:23:02

原创

244人浏览过

答案是通过解析页码和每页数量计算偏移量实现分页。首先校验前端传入的page和pageSize参数，设置默认值并防止负数或零，然后计算offset= (page-1)*pageSize，最后在数据库查询中使用LIMIT pageSize OFFSET offset获取对应数据块。

如何在golang中实现分页功能

在Go语言中实现分页功能，通常用于处理数据库查询结果的分批展示。核心思路是通过传入页码（page）和每页数量（pageSize），计算出跳过的记录数（offset），然后从数据源中取出对应的数据块。以下是具体实现方式。

1. 分页参数解析

前端一般会传递两个参数：当前页码 page 和每页显示条数 pageSize。后端需要对这些参数进行校验和默认值设置。

示例代码：

func ParsePagination(page, pageSize int) (int, int) {
    if page <= 0 {
        page = 1
    }
    if pageSize <= 0 {
        pageSize = 10
    }
    return (page - 1) * pageSize, pageSize // 返回 offset 和 limit
}

登录后复制

这里返回的是 SQL 查询所需的 offset 和 limit 值。

2. 数据库查询实现分页

使用 SQL 的 LIMIT 和 OFFSET 实现数据提取。以 MySQL 或 PostgreSQL 为例：

立即学习“go语言免费学习笔记（深入）”；

假设有一个用户表 users，我们想按创建时间倒序分页获取用户。

示例代码（使用 database/sql 或 GORM）：

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
    CreatedAt time.Time `json:"created_at"`
}
<p>// 使用 database/sql
func GetUsers(offset, limit int) ([]User, error) {
rows, err := db.Query("SELECT id, name, created_at FROM users ORDER BY created_at DESC LIMIT ? OFFSET ?", limit, offset)
if err != nil {
return nil, err
}
defer rows.Close()</p><pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">var users []User
for rows.Next() {
    var u User
    if err := rows.Scan(&u.ID, &u.Name, &u.CreatedAt); err != nil {
        return nil, err
    }
    users = append(users, u)
}
return users, nil

登录后复制

}

3. 返回分页结果结构

除了数据列表，通常还需要返回总记录数、总页数等信息，方便前端翻页控制。

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

定义分页响应结构：

type PaginatedResult struct {
    Data       interface{} `json:"data"`
    Total      int64       `json:"total"`
    Page       int         `json:"page"`
    PageSize   int         `json:"pageSize"`
    TotalPages int         `json:"totalPages"`
}

登录后复制

构造分页结果：

func GetPaginatedUsers(page, pageSize int) (*PaginatedResult, error) {
    offset, limit := ParsePagination(page, pageSize)
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">// 查询总数
var total int64
err := db.QueryRow("SELECT COUNT(*) FROM users").Scan(&total)
if err != nil {
    return nil, err
}

// 查询当前页数据
users, err := GetUsers(offset, limit)
if err != nil {
    return nil, err
}

totalPages := int((total + int64(limit) - 1) / int64(limit))

return &PaginatedResult{
    Data:       users,
    Total:      total,
    Page:       page,
    PageSize:   limit,
    TotalPages: totalPages,
}, nil

登录后复制

}

4. 在 HTTP 接口中的使用

将分页逻辑集成到 Web 路由中，比如使用 Gin 框架：

func GetUserList(c *gin.Context) {
    page, _ := strconv.Atoi(c.DefaultQuery("page", "1"))
    pageSize, _ := strconv.Atoi(c.DefaultQuery("pageSize", "10"))
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">result, err := GetPaginatedUsers(page, pageSize)
if err != nil {
    c.JSON(500, gin.H{"error": err.Error()})
    return
}
c.JSON(200, result)

登录后复制

}

访问 /users?page=1&pageSize=10 即可获取第一页数据。

基本上就这些。关键在于参数处理、SQL 分页查询和结果封装。实际项目中可根据需要加入排序、过滤条件等扩展功能。

以上就是如何在Golang中实现分页功能的详细内容，更多请关注php中文网其它相关文章！