paginate()返回空但total()有数据是因count与select不一致：paginate()默认对主表count，而with()、group或distinct使select结果变形，导致总数虚高、分页数据为空；正确做法是用显式join或wherehas()确保count与select语义统一。
paginate()返回空但total()显示有数据
这是典型的「COUNT和SELECT不一致」问题。ThinkPHP的paginate()会执行两条SQL：一条COUNT(*) FROM table，另一条是带LIMIT的主查询。如果中间加了with()、group()或distinct()，COUNT仍按原始表算，而SELECT已变形，导致总数虚高、分页数据为空。
常见触发场景：
-
UserModel::with('orders')->paginate(10)：COUNT查的是用户数，SELECT却是LEFT JOIN订单后的结果，没订单的用户被补null，但OFFSET切片仍按用户ID走，第2页可能直接跳过有订单的用户 -
Db::table('log')->group('DATE(create_time)')->paginate(15)：COUNT没GROUP，查的是全表行数；SELECT却按日期分组，实际结果远少于COUNT值 - 用了
distinct('user_id')但没同步到COUNT子句，导致COUNT重复计数
关联查询下total()与实际结果条数严重 mismatch
根本原因不是SQL写错，而是paginate()默认无法感知JOIN或子查询带来的语义变化。它只认最外层模型或表，COUNT永远落在主表上。
正确解法必须让COUNT和SELECT基于同一逻辑：
- 弃用
with()，改用显式Db::table()+join()，例如：Db::table('user')->join('order', 'user.id = order.user_id', 'INNER')->where('order.status', 1)->paginate(10) - 若必须用模型，改
whereHas()代替with()，确保COUNT也走相同WHERE条件：UserModel::whereHas('orders', function ($q) { $q->where('status', 1); })->paginate(10) - 对复杂聚合（如GROUP BY月份），禁用自动COUNT，手动传入
total参数：$list = $query->paginate(['list_rows' => 15, 'total' => $query->count()])，注意此处$query->count()必须带相同group()和where()
调用链中提前执行导致paginate()失效
paginate()不是普通方法，它必须作用于未执行的查询构造器对象。一旦调用了select()、find()、toArray()或foreach，查询就结束了，后续paginate()要么报错，要么返回空。
典型错误写法：
-
UserModel::where('status', 1)->select()->paginate(10)→select()已执行，返回Collection，paginate()无查询上下文可操作 -
$data = UserModel::where(...)->paginate(10); foreach($data as $item) {}→ 隐式触发迭代，$data被转成数组，丢失Paginator对象 -
UserModel::all()->paginate(10)→all()是终态方法，无法再分页
记住：paginate()必须是链式调用的最后一个方法，且前面只能是where、order、field等构造器方法。
listRows传参错误或配置未生效
listRows（TP6.3+）或list_rows（旧版）控制每页条数，但传错类型或位置会导致静默失败：
- 传字符串
"10"而非整数10，可能触发类型转换异常，降级为默认15条 - 在数组参数中写错键名：
['list_rows' => 20]在TP6.3+会失效，必须用驼峰['listRows' => 20] - 混淆参数顺序：
paginate(10, true, [...])中第二个参数true是$simple开关，不是listRows；正确应为paginate(['listRows' => 10, 'simple' => true]) - URL参数未透传：用户选了
per_page=20，但下一页链接仍是?page=2，没带per_page，导致回到默认15条——必须显式配置'query' => ['per_page' => input('per_page/d', 15)]
最容易被忽略的一点：分页对象一旦被toArray()或json_encode()处理，就彻底丢失render()、lastPage()等方法，模板里只能用原始$list变量，不能先赋值再传。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
