分页需传入页码和每页大小，计算偏移量实现数据库查询，返回数据及总数。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查询所需的偏移量：
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进行分页查询：
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
// 使用 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 < total,
}
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 < int(total),
}, 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方式，提升查询效率。
