答案：通过定义包含页码、每页数量和排序规则的结构体，结合GORM实现分页查询与安全排序。设置默认值并校验参数，防止SQL注入，最后在Gin框架中绑定查询参数并返回带分页信息的响应，实现安全高效的列表数据展示功能。
在实际的 Web 服务开发中，分页与排序是数据展示最常见的需求。Golang 作为后端语言，在处理数据库查询时可以通过结构体、参数解析和 SQL 拼接来实现灵活的分页排序功能。下面以一个简单的用户列表接口为例，演示如何用 Golang 实现基础的分页与排序。
定义请求参数结构体
前端通常通过 URL 查询参数传递分页和排序信息，例如：/users?page=1&size=10&sort=name,asc。我们可以定义一个结构体来接收这些参数：
type Pagination struct {
Page int `json:"page" form:"page"`
Size int `json:"size" form:"size"`
Sort string `json:"sort" form:"sort"` // 格式：字段名,方向（如 name,asc）
}
func (p *Pagination) setDefault() {
if p.Page < 1 {
p.Page = 1
}
if p.Size < 1 || p.Size > 100 {
p.Size = 10 // 默认每页10条，上限100
}
if p.Sort == "" {
p.Sort = "id,desc" // 默认按ID降序
}
}
构建数据库查询语句
使用 GORM 或原生 SQL 都可以动态拼接 LIMIT、OFFSET 和 ORDER BY 子句。以下以 GORM 为例说明：
func GetUsers(db *gorm.DB, pagination Pagination) ([]User, int64, error) {
var users []User
var total int64
// 设置默认值
pagination.setDefault()
// 获取总数
db.Model(&User{}).Count(&total)
// 解析排序字段
sortField, sortDir := "id", "desc"
if parts := strings.Split(pagination.Sort, ","); len(parts) == 2 {
field, dir := parts[0], parts[1]
if isValidField(field) { // 防止SQL注入，校验字段合法性
sortField = field
}
if dir == "asc" || dir == "desc" {
sortDir = dir
}
}
// 执行分页查询
offset := (pagination.Page - 1) * pagination.Size
result := db.Order(sortField + " " + sortDir).
Limit(pagination.Size).
Offset(offset).
Find(&users)
return users, total, result.Error}
立即学习“go语言免费学习笔记（深入）”；
注意：务必对 sort 字段进行白名单校验（如 isValidField 函数），防止恶意排序导致 SQL 注入或性能问题。
在 HTTP 接口中使用分页排序
结合 Gin 框架，可以轻松将上述逻辑集成到路由处理函数中：
自定义设置的程度更高可以满足大部分中小型企业的建站需求，同时修正了上一版中发现的BUG，优化了核心的代码占用的服务器资源更少，执行速度比上一版更快 主要的特色功能如下： 1）特色的菜单设置功能，菜单设置分为顶部菜单和底部菜单，每一项都可以进行更名、选择是否隐 藏，排序等。 2）增加企业基本信息设置功能，输入的企业信息可以在网页底部的醒目位置看到。 3）增加了在线编辑功能，输入产品信息，企业介绍等栏
func GetUserList(c *gin.Context) {
var pagination Pagination
if err := c.ShouldBindQuery(&pagination); err != nil {
c.JSON(400, gin.H{"error": err.Error()})
return
}
users, total, err := GetUsers(c.MustGet("db").(*gorm.DB), pagination)
if err != nil {
c.JSON(500, gin.H{"error": "查询失败"})
return
}
c.JSON(200, gin.H{
"data": users,
"pagination": gin.H{
"page": pagination.Page,
"size": pagination.Size,
"total": total,
"pages": (total + int64(pagination.Size) - 1) / int64(pagination.Size),
},
})}
立即学习“go语言免费学习笔记（深入）”；
这样前端就能收到包含分页元信息的标准响应，便于渲染分页控件。
总结与建议
实现分页排序的关键点在于：
- 统一参数结构，便于复用和验证
- 限制每页数量，避免数据库压力过大
- 对排序字段做白名单控制，提升安全性
- 返回总条数和页码信息，支持前端完整分页逻辑
基本上就这些。不复杂但容易忽略细节，比如默认值设置和边界检查。只要把这些封装好，后续任何列表接口都可以快速接入。
