Golang分页查询实现与示例代码

珍惜时间，勤奋学习！今天给大家带来《Golang分页实现与查询返回示例》，正文内容主要涉及到等等，如果你正在学习Golang，或者是对Golang有疑问，欢迎大家关注我！后面我会持续更新相关内容的，希望都能帮到正在学习的大家！

分页需传入页码和每页大小，计算偏移量实现数据库查询，返回数据及总数。1. 定义page和page_size参数；2. 计算offset=(page-1)*page_size；3. 执行LIMIT与OFFSET查询；4. 获取总记录数；5. 构建含数据、总数、分页信息的响应结构并返回JSON。

在使用Golang开发Web应用或API服务时，数据分页是一个常见需求。无论是查询数据库中的用户列表、文章信息还是订单记录，一次性返回大量数据不仅影响性能，还会增加网络开销。因此，实现高效的分页功能至关重要。本文将介绍如何在Golang中实现分页查询，并提供实际示例。

分页参数设计

通常分页需要两个核心参数：

• page：当前页码（一般从1开始）
• page_size 或 limit：每页显示的数据条数

根据这两个参数可以计算出SQL查询所需的偏移量：

数据库查询实现（以MySQL为例）

假设我们有一个文章表articles，结构如下：

CREATE TABLE articles (
    id INT AUTO_INCREMENT PRIMARY KEY,
    title VARCHAR(100),
    content TEXT,
    created_at DATETIME
);

使用database/sql或GORM进行分页查询：

// 使用 database/sql 示例
func GetArticles(db sql.DB, page, pageSize int) ([]Article, int, error) {
offset := (page - 1) pageSize
query := SELECT id, title, content, created_at FROM articles ORDER BY created_at DESC LIMIT ? OFFSET ?
rows, err := db.Query(query, pageSize, offset)
if err != nil {
return nil, 0, err
}
defer rows.Close()

var articles []Article
for rows.Next() {
var article Article
err := rows.Scan(&article.ID, &article.Title, &article.Content, &article.CreatedAt)
if err != nil {
return nil, 0, err
}
articles = append(articles, article)
}

// 查询总记录数
var total int
err = db.QueryRow(SELECT COUNT(*) FROM articles).Scan(&total)
if err != nil {
return nil, 0, err
}

return articles, total, nil
}

构建分页响应结构

前端通常需要知道总数量、当前页、每页大小等信息，定义一个通用的分页响应结构体：

在HTTP处理函数中返回分页结果：