Golang用Fiber框架怎么做分页查询？通用分页组件封装-Golang-PHP中文网

分页查询需严格校验参数、安全计算offset、统一过滤条件查总数与数据、返回结构化元信息；用(page-1)*limit替代前端offset，limit限10–100，总数与分页查询条件必须一致。

golang用fiber框架怎么做分页查询？通用分页组件封装

分页查询不是加个 LIMIT 和 OFFSET 就完事——Fiber 本身不提供分页能力，关键在参数校验、SQL 拼接、总数计算和响应结构这四步怎么串起来，漏一环就会返回错乱数据或被恶意刷库。

直接用 c.Query("page") 和 c.Query("limit") 拿字符串再转整型是最常见写法，但容易 panic 或返回默认值导致越界。必须做校验和兜底。

page 至少为 1，小于 1 统一设为 1；limit 建议限制在 10–100 之间，超出则截断（比如设为 50），防止恶意拉取全表
用 strconv.Atoi 转换后要检查 error，失败时返回 400 Bad Request 并附带明确错误信息，比如 "invalid page: must be integer"
不要信任前端传来的 offset，永远用 (page - 1) * limit 计算，避免 offset 被篡改绕过页码逻辑
别用 c.Query("page", "1") 的默认值兜底——它掩盖了空字符串问题，strconv.Atoi("") 会 panic，必须显式判空再转

Fiber 不处理数据库，关键是你怎么把分页参数喂给 ORM 或原生 SQL。以 PostgreSQL + pgx 为例，OFFSET/LIMIT 是最直白方式，但注意性能陷阱。

必须用 ORDER BY id（或有索引的字段）强制排序，否则分页结果可能错乱或重复
避免 OFFSET 过大（比如 OFFSET 100000），生产环境数据量大时会变慢；可考虑游标分页（WHERE id > ? ORDER BY id LIMIT ?）替代
示例片段：rows, err := db.Query(ctx, "SELECT * FROM users WHERE status = $1 ORDER BY id DESC LIMIT $2 OFFSET $3", "active", limit, (page-1)*limit)
如果用 GORM，别直接写 db.Offset(offset).Limit(limit) —— 它不校验 limit 上限，得在外层先做截断

用户需要知道当前页、总条数、总页数、是否有下一页——这些不能靠前端猜，必须后端计算并返回。别只返回数据列表。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

先查总数（SELECT COUNT(*) FROM ...），再查分页数据；两个查询用同一份 WHERE 条件，避免不一致
总页数用 (total + limit - 1) / limit 向上取整，别用 math.Ceil(float64(total)/float64(limit))，整型更稳
推荐响应结构：{"data": [], "pagination": {"page": 2, "limit": 20, "total": 137, "pages": 7, "has_next": true, "has_prev": true}}
别把 total 同时塞进 X-Total-Count header 和 response body——容易不一致；优先信 header，body 里的只作兼容或调试用

把分页逻辑硬写在 handler 里，半年后你会在 main.go 里 grep 十分钟找某个 offset 计算。真正可复用的封装，必须剥离 HTTP 上下文。

定义一个纯函数：func Paginate(query string, args []interface{}, page, limit int) (interface{}, int, error)，接收原始 SQL 和参数，返回数据切片 + 总数 + error
或者更工程化：在 repository/ 层定义接口 PageQuery(ctx context.Context, filter Filter, pager Pager) ([]User, int, error)，其中 Pager 是含 Page、Limit 的结构体
handler 层只负责调用，不碰 SQL 字符串拼接；service 层不感知 *fiber.Ctx，只返回结构体
别在封装里自动写 c.Status(200).JSON()——那会让组件无法用于 CLI 工具或测试 mock