ThinkPHP分页对象需调用->items()获取当前页数据、->total()获取总数、->currentPage()获取当前页码；直接var_dump显示object因对象懒加载，->toArray()才转为含data等字段的数组。
打印 ThinkPHP 分页对象时显示 `object` 而不是实际数据
直接 var_dump($page) 或 print_r($page) 看到的是分页对象本身（比如 think\Paginator 实例），不是你查出来的列表数据。想看真实分页内容，得先取数据集合。
ThinkPHP 的分页对象是“懒加载”的：它不自动展开数据，只在模板中调用 $page->render() 或遍历 $page 时才触发查询。调试时别被对象表象骗了。
- 要查看当前页的数据：用
$page->items()→ 返回数组，可直接dump($page->items()) - 要查看总条数：用
$page->total() - 要查看当前页码：用
$page->currentPage() - 注意：
$page->toArray()会把分页元信息（如data、last_page、per_page）转成数组，但data字段才是你要的列表，不是整个对象结构
在控制器里调试分页对象，dump() 报错或没输出
ThinkPHP 自带的 dump() 函数对某些分页对象（尤其是 V6.1+ 的 Paginator）可能触发不可序列化属性报错，比如 __debugInfo() is not allowed to throw exceptions。
这不是代码写错了，而是对象内部有闭包、资源句柄或 protected 属性未正确实现调试接口。
立即学习“PHP免费学习笔记（深入）”；
- 绕过方法：改用
echo json_encode($page->toArray(), JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT); - 更安全的做法：只 dump 关键部分，例如
dump(['items' => $page->items(), 'total' => $page->total(), 'page' => $page->currentPage()]);</li> <li>如果在 CLI 环境（如命令行测试分页逻辑），记得加 <code>exit;
防止后续输出干扰；Web 环境下建议用halt()替代die()，避免框架中间件未执行完
模板中 {$page->render()} 不显示分页 HTML，但数据正常
常见原因是分页对象没传进模板，或者用了错误的变量名。ThinkPHP 模板引擎不会自动识别 $list 是分页对象 —— 它只认你明确 assign 进去的那个变量。
- 检查控制器是否写了
$this->assign('list', $page);（V6 常用）或view::assign('list', $page); - 确认模板里调用的是
{$list->render()}，不是{$page->render()}—— 变量名必须一致 - V6 默认分页模板路径是
think\paginator\driver\Bootstrap，若自定义了主题但路径错/类名错，render()会静默失败（返回空字符串），此时应检查配置项'paginate' => ['type' => 'bootstrap']是否匹配已安装驱动 - 如果用了
simple()分页（如$query->paginate(15, false, ['simple' => true])），那对象类型是Simple，render()输出结构不同，不能混用 Bootstrap 模板
分页对象数据和数据库实际条数对不上
最常踩的坑是：查询前加了 where 条件，但分页构造时没同步应用，导致 count() 和 select() 查询条件不一致。
ThinkPHP 分页底层会先执行一次 COUNT，再执行一次 SELECT，两者必须共享完全相同的 where/group/order 条件，否则总数或数据错乱。
- 避免手动拼 SQL 或用
Db::table()->where(...)->paginate()后又单独select()—— 应统一走 Query 对象链式调用 - 使用
withCount()、withSum()等关联统计时，确保这些方法在paginate()调用前完成，否则统计不会参与 COUNT 查询 - 开启 SQL 日志（
'sql_explain' => true）后观察两条语句的 WHERE 是否一致，这是定位偏差的最快方式
