ThinkPHP分页失效主因是paginate()未作用于未执行查询构造器，导致假分页；需确保链式调用完整、GROUP BY/关联查询时手动传count、POST分页透传参数、路由命名一致。
ThinkPHP分页失效不是单一原因导致的，而是常由链式调用中断、查询条件未透传、关联或分组逻辑不匹配等几类典型问题叠加造成。修复关键在于确认 paginate() 是否真正作用于未执行的查询构造器，并确保总数统计与数据查询语义一致。
paginate() 必须作用于未执行的查询构造器
这是最常见也最容易忽略的问题。一旦在 paginate() 前调用了 select()、get()、toArray() 或 all()，查询就已执行完毕，后续 paginate() 只是对 PHP 数组做“假分页”，不会生成 LIMIT，也不会查 COUNT(*)，导致总数为 0、翻页链接无效。
- ✅ 正确写法：UserModel::where('status', 1)->order('id desc')->paginate(15)
- ✅ 带参数写法：UserModel::where('status', 1)->paginate(['list_rows' => 20, 'page' => input('page/d', 1)])
- ❌ 错误写法：UserModel::where('status', 1)->select()->paginate(10)（select 提前执行）
- ❌ 错误写法：$data = UserModel::all(); $data->paginate(10)（Collection 无 paginate 方法）
POST 查询时分页参数丢失
表单用 POST 提交大量条件后，原生分页 a 标签只带 ?page=2 这类 GET 参数，原始条件全部丢失，导致第二页空白。
- 前端用 JS 拦截分页链接，把当前 form 的 action 改为分页地址，再 submit 表单
- 后端在控制器中统一收集请求参数：request()->param()，并传给分页器的 appends 方法：$list->appends(request()->param())->render()
- 若需兼容搜索重置，提交新条件时应手动将 page 参数重置为 1，避免从非第一页开始查询
GROUP BY 或关联查询导致 total() 为 0
paginate() 底层依赖 SELECT COUNT(*) 获取总数，但 GROUP BY 查询无法直接套用原表 COUNT；关联 with() 分页则默认对主表计数，与 JOIN 后实际结果集不一致。
立即学习“PHP免费学习笔记（深入）”；
- GROUP BY 场景：改用手动分页，先查总数（如子查询或单独 COUNT），再传入 paginate 的 count 参数：paginate(15, false, ['count' => $count])
- 关联查询场景：禁用 with()，改用 join() 显式关联，并确保 COUNT 和 SELECT 使用完全相同的 WHERE、JOIN 和 alias 链路
- 例如查「用户 + 最新订单」：用子查询先算每个用户的最新时间，再 JOIN 关联订单表，COUNT 与分页基于同一逻辑
路由模式下分页 URL 生成失败
分页链接显示为 ?page=2 而非 /lists/1-2，说明 url() 函数未能反向解析命名路由，根源是路由未注册、未命名、参数名不一致或用了正则路由。
- 检查路由是否显式注册且命名：Route::get('product/lists/:id-:p', 'Product/lists')->name('product.lists')
- 调用 url() 时键名必须与路由变量名严格一致：url('product.lists', ['id' => 1, 'p' => 2])
- 多应用模式下必须加应用前缀：url('admin@user/index')
- 如需自定义路径格式，可重写 Paginator 的 url() 方法，用 [PAGE] 占位符替换页码，前提是初始化时已注入含占位符的 path
