Golang如何实现基础的分页与排序功能_Golang分页排序项目实战-Golang-PHP中文网

Golang如何实现基础的分页与排序功能_Golang分页排序项目实战

P粉602998670

发布： 2025-11-12 16:17:40

原创

985人浏览过

答案：通过定义包含页码、每页数量和排序规则的结构体，结合GORM实现分页查询与安全排序。设置默认值并校验参数，防止SQL注入，最后在Gin框架中绑定查询参数并返回带分页信息的响应，实现安全高效的列表数据展示功能。

golang如何实现基础的分页与排序功能_golang分页排序项目实战

在实际的 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）
}
<p>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降序
}
}</p>

登录后复制

构建数据库查询语句

使用 GORM 或原生 SQL 都可以动态拼接 LIMIT、OFFSET 和 ORDER BY 子句。以下以 GORM 为例说明：

func GetUsers(db *gorm.DB, pagination Pagination) ([]User, int64, error) {
    var users []User
    var total int64
<pre class='brush:php;toolbar:false;'>// 设置默认值
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 框架，可以轻松将上述逻辑集成到路由处理函数中：

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

func GetUserList(c *gin.Context) {
    var pagination Pagination
    if err := c.ShouldBindQuery(&pagination); err != nil {
        c.JSON(400, gin.H{"error": err.Error()})
        return
    }
<pre class='brush:php;toolbar:false;'>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语言免费学习笔记（深入）”；

这样前端就能收到包含分页元信息的标准响应，便于渲染分页控件。