分页与筛选功能可通过定义Pagination和Filter结构体实现，解析URL参数并结合GORM动态构建SQL查询条件，提升接口可用性与性能。
在开发 Golang 的 RESTful 接口时，分页与筛选功能是大多数数据查询接口的标配。合理设计这些功能，不仅能提升接口的可用性，还能减轻服务端和数据库的压力。下面介绍如何在 Go 中实现通用、可扩展的分页与筛选机制。
分页参数解析
通常客户端通过 URL 查询参数传递分页信息，如 page 和 limit，或使用 offset 与 limit 模式。
定义一个结构体来接收分页参数：
type Pagination struct {
Page int `json:"page"`
Limit int `json:"limit"`
Offset int `json:"-"`
}
func (p Pagination) SetOffset() {
p.Offset = (p.Page - 1) p.Limit
}
在 HTTP 处理函数中解析查询参数：
立即学习“go语言免费学习笔记（深入）”；
func parsePagination(r *http.Request) Pagination {
page := getIntQuery(r, "page", 1)
limit := getIntQuery(r, "limit", 10)
if limit > 100 {
limit = 100 // 限制最大每页数量
}
pag := Pagination{Page: page, Limit: limit}
pag.SetOffset()
return pag
}
func getIntQuery(r *http.Request, key string, defaultValue int) int {
str := r.URL.Query().Get(key)
if str == "" {
return defaultValue
}
if val, err := strconv.Atoi(str); err == nil {
return val
}
return defaultValue
}
筛选条件处理
筛选通常基于字段如状态、时间范围、关键词搜索等。可以通过结构体绑定查询参数，动态构建数据库查询条件。
聚彩手机商城系统，是一款专业于手机销售的独立手机网店系统，他拥有众多的手机参数选项，以及傻瓜式的设置选项，让您可以在５分钟内建立起专业而强大的手机销售网站。他拥有多套模版可以实时切换，前台拥有新闻中心、手机中心、配件中心、软件下载、手机报价、发货查询、保修查询、分店查询、产品的对比功能，代理与加盟的申请等功能，他拥有完善的会员中心，会员等级设置等，集成在线支付接口，超强ＳＥＯ，可以设置所有页面的t
type Filter struct {
Status string `json:"status"`
Keyword string `json:"keyword"`
StartAt string `json:"start_at"`
EndAt string `json:"end_at"`
}
根据 Filter 结构体生成 SQL 查询条件（以 GORM 为例）：
func BuildQuery(db *gorm.DB, filter Filter) *gorm.DB {
if filter.Status != "" {
db = db.Where("status = ?", filter.Status)
}
if filter.Keyword != "" {
db = db.Where("name LIKE ? OR description LIKE ?", "%"+filter.Keyword+"%", "%"+filter.Keyword+"%")
}
if filter.StartAt != "" {
db = db.Where("created_at >= ?", filter.StartAt)
}
if filter.EndAt != "" {
db = db.Where("created_at <= ?", filter.EndAt)
}
return db
}
组合分页与筛选返回响应
将分页和筛选结合，在 Handler 中调用数据库查询，并返回带总数的响应：
func GetItems(w http.ResponseWriter, r *http.Request) {
pagination := parsePagination(r)
var filter Filter
// 解析筛选参数
filter.Status = r.URL.Query().Get("status")
filter.Keyword = r.URL.Query().Get("keyword")
filter.StartAt = r.URL.Query().Get("start_at")
filter.EndAt = r.URL.Query().Get("end_at")
db := database.DB.Model(&Item{})
db = BuildQuery(db, filter)
var total int64
db.Count(&total)
var items []Item
db.Offset(pagination.Offset).Limit(pagination.Limit).Find(&items)
response := map[string]interface{}{
"items": items,
"total": total,
"page": pagination.Page,
"limit": pagination.Limit,
}
json.NewEncoder(w).Encode(response)}
基本上就这些。通过结构化分页和筛选参数，配合 ORM 动态查询，可以快速构建灵活、安全的 REST 接口。注意对输入做校验，避免 SQL 注入或性能问题。不复杂但容易忽略的是默认值控制和上限限制，这对系统稳定性很重要。
