ThinkPHP怎么使用模型字段条件分页游标优化_ThinkPHP基于ID或时间高效翻页【教程】-ThinkPHP-PHP中文网

thinkphp游标分页必须指定非null、严格单调、可比较的order字段，如id或组合create_time+id，否则会导致数据跳漏；cursorpaginate()依赖上一页末尾排序值定位下一页，需前后端严格匹配order与游标字段。

thinkphp怎么使用模型字段条件分页游标优化_thinkphp基于id或时间高效翻页【教程】

游标分页不是“加个参数就能用”，它依赖严格单调、非空、可比较的排序字段。ThinkPHP 的 cursorPaginate() 内部靠上一页最后一条记录的排序值（比如 id 或 create_time）来定位下一页起点，一旦该字段有 NULL、重复或乱序，查询直接错位甚至漏数据。

常见错误现象：cursorPaginate() 返回结果跳条、重复、或第一页之后全为空；调试时发现生成的 SQL 里 WHERE 条件用了 > 却匹配不到任何行。

必须确保 order 字段在数据库中是 NOT NULL（如 id 主键天然满足，create_time 要设默认值或应用层强制写入）
避免用 ORDER BY RAND() 或含函数的排序（如 ORDER BY ABS(id)），游标值无法稳定映射
多字段排序需谨慎：例如 ORDER BY status ASC, id DESC，游标值就得传两个（['status' => 1, 'id' => 100]），且所有字段都得参与 WHERE 构建，ThinkPHP 6.1+ 才原生支持

别直接套文档示例。ThinkPHP 的游标分页不接受传统 page/limit，而是靠客户端传来的上一页末尾记录的排序字段值（即“游标”）驱动。

使用场景：App 下拉加载、无限滚动、避免 OFFSET 深度翻页性能衰减（尤其千万级表）。

控制器里必须显式指定 order，且和前端传入的游标字段严格一致：$model->order('id desc')->cursorPaginate(20)
前端首次请求不带游标（或传空），ThinkPHP 自动按排序取第一页；后续请求需带 cursor 参数，值为上一页最后一条的 id（如 ?cursor=1005）
cursorPaginate() 返回的 data 是当前页数据，next_cursor 字段才是下一页要用的值（注意不是 last_id）—— 它是数组，内容取决于你 order 的字段数，例如 ['id' => 987]

简短示例：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

// 正确：单字段游标
$list = User::order('id desc')->cursorPaginate(15);

// 错误：没 order，或 order 和 cursor 字段不匹配
$list = User::cursorPaginate(15); // 报错或行为不可控

用 create_time 分页看着合理，但高并发下极易撞车：一秒内插入几十条记录，create_time 完全一样，WHERE create_time > '2024-05-01 10:00:00' 就会跳过其中一部分。

性能影响明显：表面用了游标，实际因重复值被迫退化成类似 OFFSET 查询，越往后越慢。

ThinkPHP 默认只认 cursor 这个 URL 参数名，且不提供钩子改解析逻辑。如果你的 App 已约定用 after 或 start_id，硬改框架源码风险大，不如绕过。

容易踩的坑：有人试图在 cursorPaginate() 前手动 where，结果和内置游标逻辑冲突，查出错乱数据。

安全做法：用原生 where + limit 模拟游标，例如 User::where('id', 'order('id desc')->limit(20)->select()，自己维护 $after 值
想保留 cursorPaginate() 的封装能力？可临时重写请求参数：input('after', null, null, 'cursor')，把 after 映射成 cursor
ThinkPHP 5.1 不支持游标分页，别找 cursorPaginate 方法——它根本不存在，强行调用报 Call to undefined method