首页 > Golang > Go教程

Golang分页排序实现方法详解

时间：2025-11-02 14:06:34 353浏览收藏

对于一个Golang开发者来说，牢固扎实的基础是十分重要的，golang学习网就来带大家一点点的掌握基础知识点。今天本篇文章带大家了解《Golang分页排序实现教程》，主要介绍了，希望对大家的知识积累有所帮助，快点收藏起来吧，否则需要时就找不到了！

答案：通过定义包含页码、每页数量和排序规则的结构体，结合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

}

注意：务必对 sort 字段进行白名单校验（如 isValidField 函数），防止恶意排序导致 SQL 注入或性能问题。

在 HTTP 接口中使用分页排序

结合 Gin 框架，可以轻松将上述逻辑集成到路由处理函数中：

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),
    },
})

}

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

总结与建议

实现分页排序的关键点在于：

统一参数结构，便于复用和验证
限制每页数量，避免数据库压力过大
对排序字段做白名单控制，提升安全性
返回总条数和页码信息，支持前端完整分页逻辑

基本上就这些。不复杂但容易忽略细节，比如默认值设置和边界检查。只要把这些封装好，后续任何列表接口都可以快速接入。

理论要掌握，实操不能落！以上关于《Golang分页排序实现方法详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！