ThinkPHP分页不显示页码快速修复处理方案-ThinkPHP-PHP中文网

分页html为空的主因是分页对象未成功生成或被意外转换：tp3/tp5中总条数为0或变量名错误导致page实例构造失败；tp5/tp6中调用toarray()等方法使$list变为数组而丢失分页信息；需检查变量值、类型及query参数传递。

thinkphp分页不显示页码快速修复处理方案

分页 HTML 为空（$show 或 $list->render() 输出空字符串），基本就是分页对象没生成成功，或被意外“解包”了。

最常见原因是构造 Page 实例时传入的总条数为 0 或变量名写错——比如把 $showscount 写成 $trendscount，导致 new Page(0, 3)，内部直接跳过渲染逻辑。

检查 $showscount = $showtrends->count(); 是否真返回了大于 0 的整数（加 dump($showscount);exit; 确认）
确保 Page 构造函数第一个参数是数字，不是 null、false 或未定义变量
TP3 中若用了命名空间或自动加载失败，import('ORG.Util.Page') 可能静默失败，改用 vendor('Page', THINK_PATH.'Extend/Library/ORG/Util/Page'); 或直接复制类文件到项目目录
模板里输出时别漏掉 |raw（TP5/6）或 htmlspecialchars_decode（TP3），否则 HTML 被转义成纯文本

根本原因：你拿到的 $list 已不是 Paginator 实例，而是数组或 Collection。只要中间调过 toArray()、all()、foreach 或 json_encode()，分页元信息就丢了。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

确认控制器中分页调用后没接任何转换方法：$list = User::paginate(15); ✅，$list = User::paginate(15)->toArray(); ❌
TP6 中若数据库配置开启了 'collection' => true，会强制把分页结果转成 Collection，关掉它（设为 false）
模板中必须用 {$list->render|raw}（TP6）或 {:widget('think\paginator\driver\Bootstrap', $list)}（TP5.1），不能直接 {$list}
如果用了 with() 关联预载入，且主查询带 field()，可能导致 COUNT SQL 生成失败，fallback 到无总数的 simple 分页，render() 仍可输出但逻辑异常

现象是点下一页后回到第一页数据，URL 里只剩 ?page=2，其他条件全没了——这不是分页失效，是 query 没传对。

必须显式把影响查询的参数塞进 paginate() 的 query 选项里：paginate(['list_rows'=>15, 'query'=>['year'=>$year, 'cat'=>$cat]])
别用 input('year') 直接取，要过滤空值：array_filter(['year'=>input('year/d'), 'cat'=>input('cat/d')])，避免生成 ?year=&cat=1
如果参数来自 POST 表单，需在控制器里手动合并：$list->appends(array_merge($searchData, ['page'=>$request->page]))
TP6.3+ 开始，list_rows 必须写成 listRows（驼峰），旧写法不报错但静默失效，每页永远是默认 15 条

当查百万级数据时，paginate(20) 会先执行 COUNT(*)，超时或慢查询导致整个分页对象初始化失败，render() 自然为空。

临时验证：把 paginate(20) 改成 paginate(20, false)（TP5/6 均支持），跳过总数统计，看 render() 是否恢复输出
若恢复，说明是 COUNT 拖垮了——立刻加复合索引（如 (status, create_time)），并考虑切换游标分页
simple 模式下模板要改用 {$list->simple()->render()}，否则 render() 内部仍尝试读取总页数而报错
别在生产环境依赖 dump() 或 echo 查问题，开启 ThinkPHP 日志（log.trace）看实际执行的 SQL 和耗时