simplePaginate() 不生成 next_page_url 是设计使然，它不查总数、只多取一条判断是否有下一页，故仅提供 nextPageUrl、previousPageUrl 和 hasMorePages 等驼峰字段。
simplePaginate() 不生成 next_page_url？不是 bug，是设计使然。 它压根不查总数，只多取一条判断「有没有下一页」，所以不可能有 next_page_url、prev_page_url 或 last_page_url —— 你看到的其实是 nextPageUrl（驼峰）和 hasMorePages。
为什么 simplePaginate() 返回的 data 是空数组？
常见错误现象：请求第 1000 页，data 为空，但 hasMorePages 还是 true。
- 这是 Laravel 的预期行为，不是数据丢失或查询失败
- 底层执行的是
LIMIT offset, perPage + 1，当offset已超出有效范围（比如总共只有 500 条，却请求第 1000 页），数据库返回空结果集，但分页器仍按「可能还有」逻辑设hasMorePages = true - 前端必须同时检查
data.length > 0和hasMorePages，不能只依赖后者追加内容 - 确认没误写成
$query->get()->simplePaginate(15)—— 那会先拉全量再内存分页，极慢且失效
simplePaginate() 的 URL 字段名到底是啥？
别在代码里硬写 next_page_url 或 previous_page_url，Laravel 9+ 默认返回的是驼峰命名：
-
nextPageUrl（不是next_page_url） -
previousPageUrl（不是prev_page_url） - 字段名不统一时，前端解析会始终为
null，尤其在 API 响应中容易踩坑 - 如果你的前端协议强制要求下划线风格（如
has_next），就得手动构造响应体，不能直接return response()->json($posts->simplePaginate(10))
什么时候该用 simplePaginate()？
它适合「不需要总条数、不显示页码数字、只提供加载更多/下一页」的场景：
- 移动端 Feed 流、聊天消息列表、日志查看页
- 数据量大（10 万+ 行）、联表复杂、
COUNT(*)明显拖慢响应时 - 排序字段未显式指定（如漏掉
orderBy('id')）会导致结果重复或跳行 —— 必须补上唯一、稳定、有索引的排序字段 - 模型启用了全局作用域（如软删除），
simplePaginate()仍受其影响；需确认withTrashed()等调用位置是否在分页前
最常被忽略的一点：simplePaginate() 返回的是 SimplePaginator 实例，它的 meta 极简（只有 current_page 和 per_page），没有 total、last_page —— 如果你的前端组件默认读这些字段，会直接崩掉。别假设它和 paginate() 兼容。
