安全分页需封装带默认值和边界检查的解析函数,如parsePage返回1(page

分页参数怎么从 HTTP 请求里安全取出来
直接用 c.QueryParam("page") 或 c.FormValue("page") 拿字符串再转整数,容易 panic。Fiber 默认不校验输入,"page=abc" 会触发 strconv.Atoi 错误,导致 500 响应。
正确做法是封装一个带默认值和边界检查的解析函数:
func parsePage(c *fiber.Ctx) int {
page, err := strconv.Atoi(c.QueryParam("page"))
if err != nil || page func parsePageSize(c *fiber.Ctx) int {
size, err := strconv.Atoi(c.QueryParam("size"))
if err != nil || size 100 {
return 20
}
return size
}
- 硬性限制
size上限(比如 100),防恶意请求拖垮数据库 - 不要信任前端传来的任何数字,默认值设为 1 / 20 更符合直觉
- 别用
c.Params("page")——那是路径参数,不是查询参数
数据库层怎么写 LIMIT OFFSET 才不出错
Fiber 本身不处理数据库,但分页逻辑紧耦合 SQL 的 LIMIT 和 OFFSET。常见错误是把页码直接当 offset:第 3 页、每页 20 条,写成 OFFSET 3 而不是 OFFSET 40。
计算公式必须是:offset = (page - 1) * size。用 ORM(如 GORM)时尤其要注意:
// ✅ 正确:GORM 分页写法 var users []User db.Offset((page - 1) * size).Limit(size).Find(&users) <p>// ❌ 错误:没减 1,第 1 页就跳过前 size 条 db.Offset(page * size).Limit(size).Find(&users)</p>
- PostgreSQL/MySQL 对
OFFSET大值性能敏感,超过 10w 行建议改用游标分页(WHERE id > ?) - SQLite 不支持负数
LIMIT,但 Fiber 通常不跑在 SQLite 上,可忽略 - 如果用原始 SQL,记得对
page和size做参数化,避免 SQL 注入
怎么返回总条数和分页元信息给前端
前端需要知道总页数、当前页、是否还有下一页,不能只扔个数组过去。Fiber 没内置分页响应结构,得自己构造 JSON。
关键点是:总条数要单独查一次 COUNT(*),不能靠 len(结果切片) —— 那只是当前页数量。
// 先查总数(注意 WHERE 条件要和主查询一致)
var total int64
db.Model(&User{}).Where("status = ?", status).Count(&total)
<p>// 再查数据
var users []User
db.Where("status = ?", status).
Offset((page - 1) * size).
Limit(size).
Find(&users)</p><p>// 组装响应
c.JSON(fiber.Map{
"code": 0,
"data": users,
"meta": fiber.Map{
"total": total,
"page": page,
"size": size,
"pages": int((total+int64(size)-1)/int64(size)), // 向上取整
"has_next": int64(page)*int64(size) 1,
},
})</p>
-
pages计算别用total / size,整除会丢页;用(total + size - 1) / size是通用向上取整技巧 - 如果数据量极大且 COUNT 很慢,可考虑缓存总条数,或返回模糊值(如 “>10000”)
- 别把
meta放根节点下,和data平级更利于前端解构
为什么用游标分页比 LIMIT OFFSET 更可靠
当用户快速翻到第 500 页,OFFSET 9999 在 MySQL 里可能扫全表,延迟飙升;更麻烦的是,如果中间有数据增删,OFFSET 分页会出现漏行或重复。
游标分页用上一页最后一条记录的唯一字段(如 id 或 created_at)做条件,天然稳定:
// 第一页 SELECT * FROM users ORDER BY id DESC LIMIT 20; <p>// 第二页(用第一页最后一条的 id) SELECT * FROM users WHERE id </p>
- 必须有索引支撑排序字段,否则性能更差
- Fiber 层只需解析
c.QueryParam("cursor"),不再需要page参数 - 无法跳转任意页(比如直接点“第 100 页”),适合信息流场景,不适合管理后台
游标分页不是银弹,但高并发、大数据量、实时性要求高的接口,它比传统分页更值得优先考虑。真正难的不是写代码,而是判断该用哪种分页策略——这取决于你的数据更新频率和前端交互模式。











