Buffalo 框架不原生支持 cursorPaginate；需手动构造 SQL，如 WHERE id > ? ORDER BY id ASC LIMIT ?，并确保 id 有主键或唯一索引；复合游标（如 created_at, id）须自行解析拼接 WHERE 条件。
Buffalo 框架不原生支持 cursorPaginate
Buffalo 是一个 Go 语言 Web 框架，它本身没有像 Laravel 的 cursorPaginate() 那样的内置游标分页方法。所有分页逻辑必须由你手动构造 SQL 查询条件、处理游标参数、并确保索引与排序严格对齐——否则很容易漏数据或重复。
用 WHERE id > ? ORDER BY id ASC LIMIT ? 实现最简游标分页
这是 Buffalo 中最常用、也最稳妥的起步方式，适用于按主键递增顺序分页的场景（如日志、订单列表）。
- 前端首次请求不带游标，后端执行：
SELECT * FROM orders ORDER BY id ASC LIMIT 20 - 取响应中最后一条记录的
id（比如是10042），Base64 编码后返回给前端作为next_cursor - 下一次请求带
cursor=MTAwNDI=，后端解码得10042，执行：SELECT * FROM orders WHERE id > 10042 ORDER BY id ASC LIMIT 20 - 必须为
id字段建主键或唯一索引，否则WHERE id > ?可能跳过重复值或命中非预期行
复合游标（如 created_at, id）要手写 WHERE 条件拼接
当需要按时间倒序 + 主键去重时（例如“最新动态”），不能依赖框架自动解析游标结构，必须自己拆解和生成 WHERE 子句。
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
- 游标值应是类似
"2026-09-19T14:22:05Z,10042"的字符串，用逗号分隔，服务端需strings.Split(cursorStr, ",")解析 - 对应 SQL 必须写成：
WHERE (created_at ，注意方向：倒序时用，正序时用> - 数据库索引必须严格匹配排序顺序：
CREATE INDEX idx_created_at_id ON posts (created_at DESC, id DESC) - 如果
created_at精度是秒级且存在并发插入，id就是防止歧义的兜底字段，缺一不可
Buffalo 中最容易被忽略的三个坑
这些不是语法错误，但上线后会导致线上数据错乱，且难以复现。
- 游标值未做防篡改校验：客户端可随意修改 Base64 游标，应在校验阶段加签名或使用加密 token（如
hmac.New(...)包裹原始游标） - 忽略 NULL 值行为：若排序字段允许 NULL（如
deleted_at），WHERE deleted_at 会跳过所有 NULL 行，需显式补OR deleted_at IS NULL并调整索引覆盖 - 前端未正确传递游标方向：游标分页天然不支持“跳转到第 N 页”，但有人强行在 URL 里拼
?page=5，结果游标失效；应彻底移除页码参数，只留cursor和limit
游标分页在 Buffalo 里没有魔法，它的稳定性和性能完全取决于你写的那条 WHERE 子句是否和索引、排序、数据变更逻辑严丝合缝。别省那几行 SQL 拼接代码，也别信“通用分页中间件”——真正可靠的游标逻辑，永远是贴着业务字段长出来的。
