分页查询通过定义Pagination结构体接收页码和每页数量，利用GetOffset和GetLimit方法计算sql的OFFSET和LIMIT值，结合数据库查询获取数据列表与总记录数，再通过PaginatedResult封装包含数据、总数、当前页等信息的响应结果，最后在gin框架中绑定请求参数并返回分页数据，实现高效、可复用的分页功能。
在go语言开发中，分页查询是处理数据库大量数据时最常见的需求之一。无论是后台管理系统、API接口还是Web应用，都需要将数据分批次展示，避免一次性加载过多内容导致性能下降。下面介绍如何在golang中实现一个基础但实用的分页查询功能。
1. 定义分页参数结构体
为了统一管理分页请求的数据，通常会定义一个结构体来接收前端传入的分页信息：
type Pagination struct { Page int `json:"page" form:"page"` // 当前页码 PageSize int `json:"page_size" form:"page_size"` // 每页数量 } <p>func (p <em>Pagination) GetOffset() int { return (p.Page - 1) </em> p.PageSize }</p><p>func (p *Pagination) GetLimit() int { return p.PageSize }</p>
这里使用了form标签，方便与Gin等Web框架结合解析URL参数或JSON请求体。GetOffset和GetLimit方法用于生成SQL查询中的LIMIT和OFFSET值。
2. 数据库查询与总数统计
分页需要两个关键数据：当前页的数据列表和总记录数。以mysql为例，假设有一个文章表articles：
立即学习“go语言免费学习笔记（深入）”；
type Article struct { ID int `json:"id"` Title string `json:"title"` Content string `json:"content"` Created time.Time `json:"created"` } <p>func GetArticles(p *Pagination) ([]Article, int64, error) { var articles []Article var total int64</p><pre class='brush:php;toolbar:false;'>db := GetDB() // 获取数据库连接（*sql.DB 或 GORM DB） // 先获取总数量 db.Model(&Article{}).Count(&total) // 查询分页数据 result := db.Offset(p.GetOffset()).Limit(p.GetLimit()).Find(&articles) if result.Error != nil { return nil, 0, result.Error } return articles, total, nil
}
query := "SELECT id, title, content, created FROM articles LIMIT ? OFFSET ?" rows, err := db.Query(query, p.GetLimit(), p.GetOffset()) ...
3. 构建分页响应结果
返回给前端的数据应包含列表、总数、当前页、页大小等信息，便于前端控制翻页逻辑：
type PaginatedResult struct { Data interface{} `json:"data"` Total int64 `json:"total"` Page int `json:"page"` PageSize int `json:"page_size"` TotalPages int `json:"total_pages"` } <p>func NewPaginatedResult(data interface{}, total int64, page, pageSize int) *PaginatedResult { totalPages := int((total + int64(pageSize) - 1) / int64(pageSize)) return &PaginatedResult{ Data: data, Total: total, Page: page, PageSize: pageSize, TotalPages: totalPages, } }</p>
4. 在http接口中集成分页
以Gin框架为例，实现一个分页查询接口：
func GetArticlesHandler(c *gin.Context) { var pagination Pagination <pre class='brush:php;toolbar:false;'>// 绑定查询参数 if err := c.ShouldBindQuery(&pagination); err != nil { c.JSON(400, gin.H{"error": err.Error()}) return } // 设置默认值 if pagination.Page == 0 { pagination.Page = 1 } if pagination.PageSize == 0 { pagination.PageSize = 10 } articles, total, err := GetArticles(&pagination) if err != nil { c.JSON(500, gin.H{"error": "查询失败"}) return } result := NewPaginatedResult(articles, total, pagination.Page, pagination.PageSize) c.JSON(200, result)
}
前端可以通过/articles?page=1&page_size=10进行访问，后端自动完成分页处理。
基本上就这些。这套模式简单清晰，适用于大多数中小型项目。随着业务复杂度上升，可进一步封装成通用分页工具函数，支持排序、条件筛选等扩展功能。关键是理解分页的核心逻辑：偏移计算、数量限制和总数返回。