Buffalo框架不支持内置游标分页，其Paginate仅基于offset；需手动实现：首请求查LIMIT n+1并提取末条id作next_cursor，后续请求用WHERE id

Buffalo 框架里没有内置游标分页支持

Buffalo 本身不提供类似 cursor_paginate 这样的开箱即用方法，它的 Paginate 只支持基于 offset 的分页（limit + offset）。游标分页必须手动实现，核心是：用上一页最后一条记录的排序字段值（比如 id 或 created_at）作为下一页查询的起点条件。

手动实现游标分页的关键三步

以 PostgreSQL 为例，假设按 id 降序分页，每页 20 条：

• 客户端首次请求不带游标，服务端查前 20 条：SELECT * FROM posts ORDER BY id DESC LIMIT 21（多查 1 条用于判断是否有下一页）
• 返回数据时，提取第 20 条的 id 值作为 next_cursor；若查到 21 条，说明还有下一页，否则 next_cursor = null
• 下一页请求携带 cursor=12345，服务端执行：SELECT * FROM posts WHERE id

注意：WHERE 条件中的比较符必须和 ORDER BY 方向严格匹配（DESC → ，<code>ASC → >），否则结果错乱。

在 Buffalo handler 中拼接游标查询的常见写法

别依赖 buffalo.Pop 的 Paginate，直接用 q.Where 和 q.Limit 构建查询：

Buffalo框架 1.0.1

Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。

下载

// 示例：按 created_at DESC 游标分页
cursor := r.URL.Query().Get("cursor")
var posts []models.Post
q := tx.Q()
if cursor != "" {
    t, err := time.Parse(time.RFC3339, cursor)
    if err != nil {
        return errors.WithStack(err)
    }
    q = q.Where("created_at < ?", t)
}
err := q.Order("created_at DESC").Limit(21).All(&posts)

关键点：

• 游标值必须可被数据库安全比较，优先选单调递增/递减字段（id、created_at），避免用可能重复的字段（如 status）
• 务必对游标参数做校验和类型转换，防止 SQL 注入或 panic
• 返回时把游标值从结果集中显式提取，不要靠索引硬算（例如取 len(posts)-1 可能因 LIMIT 不足而越界）

为什么不能直接复用 Buffalo 的 Paginate 方法

Paginate 内部固定使用 OFFSET，且封装了 total count 查询——这正是游标分页要避免的（count 开销大、无法精确反映“实时总数”）。强行绕过会导致：

• 生成形如 SELECT ... OFFSET ? LIMIT ? 的 SQL，失去游标语义
• 自动触发 SELECT COUNT(*)，抵消游标分页的性能优势
• 无法控制 WHERE 条件插入时机，游标逻辑被迫写在 Paginate 外层，易出错

游标分页真正复杂的地方不在 SQL 拼写，而在游标值的编码、传输和幂等性处理——比如多个字段组合游标（id, created_at）时需用字符串拼接并 URL 安全编码，这些 Buffalo 不管，得你自己收口。