ThinkPHP分页不执行count关闭统计查询方法-ThinkPHP-PHP中文网

thinkphp分页默认执行count查询，可通过withouttotalcount(true)关闭（需tp6.0.8+及兼容驱动），或手动构造paginator传入已知总数/设为null，避免冗余统计。

thinkphp分页不执行count关闭统计查询方法

ThinkPHP 分页默认会执行 COUNT 查询，但实际场景中你可能已经知道总条数、用缓存存了总数、或根本不需要精确总数（比如只显示“下一页”）——这时候强行关掉 COUNT 是合理且必要的。

为什么 `count()` 会被自动触发

ThinkPHP 的 paginate() 方法内部会先调用 count() 获取总记录数，再执行 LIMIT 查询。即使你传了 $listRows 和 $simple = false，只要没显式干预，COUNT 就跑不掉。

常见错误现象：EXPLAIN 发现分页 SQL 多出一条 SELECT COUNT(*)；慢查询日志里 COUNT 占比高；数据量大时翻页卡顿明显。

这是设计使然，不是 bug —— TP 需要总数来算页码、总页数、是否显示“尾页”等
但如果你用的是游标分页、前端无限滚动、或总数已由其他方式确定（如 Redis 缓存），COUNT 就成了冗余开销
->withoutTotalCount() 是官方提供的开关，但它只在特定版本和驱动下生效，不能无脑套用

`withoutTotalCount(true)` 的使用前提和坑

这个方法仅在 ThinkPHP 6.0.8+ 且数据库驱动支持（如 MySQL 8.0+、PostgreSQL）时才真正跳过 COUNT。低版本或 SQLite、SQL Server 等可能被忽略，仍会执行 COUNT。

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

必须在调用 paginate() 前链式调用，顺序不能错：$query->withoutTotalCount(true)->paginate(15)
它不会修改原始查询对象，所以不能写成 $query->withoutTotalCount(true); $query->paginate(15)（后者无效）
开启后 $page->lastPage()、$page->total() 返回 null 或 0，模板里别直接 echo 这些值，否则报错
简单分页（simple = true）本身就不查总数，但只提供上一页/下一页链接，不适用需要页码的场景

手动构造分页对象绕过 COUNT（兼容所有版本）

当 withoutTotalCount() 不可用或不可靠时，最稳的方式是自己拼分页数据：查数据 + 手动设总数（或设为 null）+ 实例化 Paginator。

示例（TP6）：

// 假设你已从缓存拿到总数 $totalFromCache = 12345;
$data = Db::name('article')->where($where)->limit($offset, $limit)->select();
$paginator = new \think\Paginator($data, $listRows, $page, [
    'total' => $totalFromCache,
    'path'  => url('index/article'),
    'query' => request()->param(),
]);
// 注意：这里 total 是你给的，不是框架算的，COUNT 彻底没发生