如何在Golang中实现数据分页_Golang 数据分页实践

分页需控制查询范围、返回元数据并校验参数。使用page和page_size计算offset，结合LIMIT与OFFSET实现数据库分页，但深度分页应改用游标法；定义PaginatedResponse结构体返回数据、总数、页码等信息，并对输入进行合法性检查，防止性能问题与异常请求。

在Golang开发中，处理大量数据时实现分页是常见需求。无论是API接口返回列表数据，还是后台管理系统展示记录，直接加载全部数据会影响性能和用户体验。合理的分页机制可以提升响应速度、减少内存占用。下面介绍如何在Golang中实现高效、易用的数据分页。

理解分页基本参数

分页通常依赖几个关键参数：

• page：当前页码，一般从1开始
• page_size 或 limit：每页显示的条数
• offset：偏移量，计算方式为 (page - 1) * page_size

例如请求第2页，每页10条，则跳过前10条，取10条数据。这些参数应通过HTTP查询参数传入，并做校验防止非法输入。

数据库层面实现分页查询

最常见的是使用SQL的 LIMIT 和 OFFSET 进行分页。以MySQL为例：

SELECT id, name, created_at FROM users ORDER BY created_at DESC LIMIT ? OFFSET ?

在Golang中结合database/sql或GORM等ORM使用：

var users []User
offset := (page - 1) * pageSize
db.Limit(pageSize).Offset(offset).Order("created_at DESC").Find(&users)

注意：OFFSET随着页码增大，性能会下降。对于深度分页（如第1000页），建议使用基于游标的分页（如按时间或ID排序后用WHERE过滤）。

构建通用分页响应结构

返回前端的数据应包含分页元信息，便于前端控制翻页。定义一个通用响应结构体：

type PaginatedResponse struct {
    Data       interface{} `json:"data"`
    Total      int64       `json:"total"`
    Page       int         `json:"page"`
    PageSize   int         `json:"page_size"`
    TotalPages int         `json:"total_pages"`
}

在处理完查询后填充该结构：

var total int64
db.Model(&User{}).Count(&total)
var users []User
db.Limit(pageSize).Offset((page-1)*pageSize).Find(&users)
response := PaginatedResponse{
Data:       users,
Total:      total,
Page:       page,
PageSize:   pageSize,
TotalPages: int(math.Ceil(float64(total) / float64(pageSize))),
}

处理边界与异常输入

用户可能传入负数页码或超大的page_size，需进行校验：

if page < 1 {
    page = 1
}
if pageSize < 1 {
    pageSize = 10
}
if pageSize > 100 {
    pageSize = 100 // 限制最大值防刷
}

还可以封装成工具函数，复用在多个Handler中。

基本上就这些。核心是控制查询范围、返回必要元数据，并做好安全校验。不复杂但容易忽略细节。