Golang分页实现与查询示例
分页需传入页码和每页大小，计算偏移量实现数据库查询，返回数据及总数。1.定义page和page_size参数；2.计算offset=(page-1)*page_size；3.执行LIMIT与OFFSET查询；4.获取总记录数；5.构建含数据、总数、分页信息的响应结构并返回JSON。
分页需传入页码和每页大小，计算偏移量实现数据库查询，返回数据及总数。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，结构如下：
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
}
构建分页响应结构
前端通常需要知道总数量、当前页、每页大小等信息，定义一个通用的分页响应结构体：
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方式，提升查询效率。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。
AirBuddy 3 是面向 macOS 的蓝牙外设增强工具，可集中查看 AirPods、Beats 与苹果设备电量，提供快速连接、播放控制、电量提醒、桌面小组件和多台 Mac 外设接力等功能。
AirServer macOS版可把 Mac 转换为无线投屏接收端，通过 AirPlay 或 Google Cast 接收手机、平板和电脑画面，并支持多设备同时连接、高清镜像及会话录制，适合家庭娱乐、课堂教学、会议演示和应用展示。
火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力，依托字节自研豆包多模态大模型，凭借火山方舟一站式平台，提供模型精调、推理部署、智能应用搭建等全链路服务，结合高性能AI算力，助力各行业快速落地大模型数字化与智能化应用。
PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台，提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具，适合短剧、漫剧、广告及社交媒体内容制作。
Autodesk Maya 是面向影视、电视、动画和游戏行业的专业三维制作软件，集多边形与 NURBS 建模、角色绑定、关键帧和动作捕捉动画、Bifrost 特效模拟、材质开发及 Arnold 渲染于一体，