ThinkPHP 6 分页必须由 paginate() 统一控制，offset() 会被重置；应使用 page() 和 listRows 指定页码与每页条数，游标分页需手动实现。
ThinkPHP 6 的 offset() 不能直接用于分页
直接调用 offset() + limit() 做“手动偏移分页”，在 ThinkPHP 6 中无法和 paginate() 共存——因为 paginate() 内部会重置查询，你之前设的 offset() 会被丢弃。这不是 bug，是设计逻辑：分页必须由 paginate() 统一控制起始位置。
正确设置起始偏移量要用 page() 和 listRows
ThinkPHP 分页的“偏移量”本质是页码 × 每页条数，所以你要控制偏移，实际是控制当前页码。比如想从第 100 条开始查（即 offset=100），每页 15 条，那对应的是第 ceil(100 / 15) = 7 页（注意页码从 1 开始）。
实操建议：
- 用
page(7)显式指定页码，再传listRows=15给paginate() - 不要自己算 offset 后调
offset(100)->limit(15)，这会绕过分页器的总数统计和链接生成 - 若需动态起始位置（如加载更多场景），统一转换为“页码 + 每页数”再调用
paginate() -
paginate()默认读取 GET 参数page，你也可以用paginate(15, false, ['page' => 7])强制指定
自定义 offset 场景（如游标分页）别硬套 paginate()
如果你真需要基于 ID 或时间戳的偏移（比如 WHERE id > 12345 ORDER BY id LIMIT 20），这不是传统 offset 分页，而是游标分页（cursor-based pagination）。ThinkPHP 的 paginate() 不支持这种模式。
此时应该：
- 放弃
paginate()，手写where()->order()->limit(20)查询 - 自行处理下一页的游标值（如记录最后一条的
id） - 不依赖
total和页码跳转，避免COUNT(*)性能问题 - 注意：这种写法无法用
render()生成分页 HTML，需前端自行拼接“下一页”链接
常见错误：offset() 被忽略还报错 SQLSTATE[42000]: Syntax error
典型现象：代码写了 $query->offset(50)->limit(10)->paginate(10)，结果查出第 1 页数据，甚至 SQL 报错说 OFFSET 语法不对。
原因很直接：
- ThinkPHP 6.1+ 的
paginate()会清空之前链式调用的offset/limit - 部分数据库（如 MySQL 5.7 以前）不支持
LIMIT x OFFSET y写法，而 TP 在某些配置下可能生成该语法 - 更隐蔽的问题：开启
use_transaction或使用withCount()时，分页子查询可能让OFFSET出现在错误位置
解决方法只有一条：删掉所有 offset()，改用 page() 控制起始位置。
真正要小心的是把“偏移量思维”直接平移到 ThinkPHP 分页上——它抽象的是页码，不是 SQL 的 offset。游标分页或大数据跳转场景，得换思路，而不是强行给 paginate() 打补丁。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
