Golang如何实现数据分页功能_Golang分页查询与返回示例-Golang-PHP中文网

Golang如何实现数据分页功能_Golang分页查询与返回示例

P粉602998670

发布： 2025-12-20 16:21:08

原创

366人浏览过

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

golang如何实现数据分页功能_golang分页查询与返回示例

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

分页参数设计

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

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

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

offset = (page - 1) * page_size

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

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

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

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

登录后复制

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

Seed-TTS

Seed-TTS 是一个高质量多功能的文本到语音生成模型

909

查看详情

// 使用 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
}

构建分页响应结构

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

type PaginationResponse struct {
Data interface{} `json:"data"`
Total int `json:"total"`
Page int `json:"page"`
PageSize int `json:"page_size"`
HasMore bool `json:"has_more"`
}

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

func ArticlesHandler(w http.ResponseWriter, r *http.Request) {
page := parseInt(r.URL.Query().Get("page"), 1)
pageSize := parseInt(r.URL.Query().Get("page_size"), 10)

articles, total, err := GetArticles(db, page, pageSize)
if err != nil {
http.Error(w, err.Error(), 500)
return
}

response := PaginationResponse{
Data: articles,
Total: total,
Page: page,
PageSize: pageSize,
HasMore: page*pageSize }

w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(response)

使用GORM简化分页操作

如果项目中使用GORM，可以更简洁地实现分页：

func GetArticlesWithGORM(db *gorm.DB, page, pageSize int) (*PaginationResponse, error) {
var articles []Article
var total int64

db.Model(&Article{}).Count(&total)
db.Scopes(Paginate(page, pageSize)).Find(&articles)

return &PaginationResponse{
Data: articles,
Total: int(total),
Page: page,
PageSize: pageSize,
HasMore: page*pageSize }, nil
}

// Paginate 是一个可复用的 GORM Scope
func Paginate(page, pageSize int) func(db *gorm.DB) *gorm.DB {
offset := (page - 1) * pageSize
return func(db *gorm.DB) *gorm.DB {
return db.Offset(offset).Limit(pageSize)
}
}

基本上就这些。通过合理设计分页参数、正确计算偏移量，并结合数据库查询与响应封装，就能在Golang中高效实现分页功能。注意对输入参数做校验，避免恶意请求导致性能问题。对于大数据量场景，建议使用游标分页（cursor-based pagination）替代传统offset方式，提升查询效率。

以上就是Golang如何实现数据分页功能_Golang分页查询与返回示例的详细内容，更多请关注php中文网其它相关文章！