分页推荐使用offset/limit模式，结合排序索引和参数校验，避免深度分页性能问题，建议对大数据量采用游标分页并缓存高频结果以提升性能。

在使用 Golang 开发 Web 接口时，分页是处理大量数据的常见需求。合理的分页机制不仅能提升接口响应速度，还能降低数据库压力。下面介绍如何在 Golang 中实现高效、安全的分页功能，并提供优化建议。

基本分页参数设计

通常分页通过 页码（page） 和每页数量（page_size）控制，或使用 偏移量（offset） 与 限制数（limit） 实现。推荐使用 offset/limit 模式，更贴近数据库操作。

示例请求参数：

• offset=0：起始位置
• limit=10：每页取10条

服务端解析代码示例：

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

func ParsePagination(query url.Values) (offset, limit int) {
    offset, _ = strconv.Atoi(query.Get("offset"))
    if offset < 0 { offset = 0 }
<pre class="brush:php;toolbar:false;">limit, _ = strconv.Atoi(query.Get("limit"))
if limit <= 0 || limit > 100 { // 限制最大值防刷
    limit = 20
}
return

}

数据库查询实现分页

以 MySQL 为例，使用 OFFSET 和 LIMIT 子句进行数据切片：

query := "SELECT id, name, created_at FROM users ORDER BY id DESC LIMIT ? OFFSET ?"
rows, err := db.Query(query, limit, offset)

若使用 GORM 等 ORM，可简化为：

Golang Google Wire

在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface

下载

var users []User
db.Limit(limit).Offset(offset).Order("id desc").Find(&users)

注意：排序字段应有索引，避免全表扫描。

返回分页元信息

除了数据列表，接口应返回总条数和分页状态，便于前端控制翻页逻辑。

type PaginatedResponse struct {
    Data       interface{} `json:"data"`
    Total      int64       `json:"total"`
    Offset     int         `json:"offset"`
    Limit      int         `json:"limit"`
    HasMore    bool        `json:"has_more"`
}

构建响应：

var total int64
db.Model(&User{}).Count(&total)
<p>response := PaginatedResponse{
Data:    users,
Total:   total,
Offset:  offset,
Limit:   limit,
HasMore: offset + limit < int(total),
}

性能优化建议

当数据量大时，深度分页（如 OFFSET 100000）会导致性能下降，因为数据库仍需扫描前 N 条记录。

优化方案：

• 使用游标分页（Cursor-based Pagination）：基于上一页最后一条记录的某个有序字段（如 ID 或时间）继续查询，避免 OFFSET。
• 示例 SQL：SELECT * FROM users WHERE id
• 适合不可变或按时间递增的数据流，如日志、消息列表。
• 加索引：确保排序和查询字段有合适索引。
• 缓存高频分页：对不常变的数据，可用 Redis 缓存某页结果，设置合理过期时间。

基本上就这些。Golang 实现分页简单直接，关键在于参数校验、SQL 优化和返回结构设计。根据业务场景选择 offset 分页或游标分页，能显著提升系统稳定性与响应速度。