分页推荐使用 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} 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，可简化为：
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) 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 分页或游标分页，能显著提升系统稳定性与响应速度。
