分页HTML为空的主因是分页对象未成功生成或被意外转换：TP3/TP5中总条数为0或变量名错误导致Page实例构造失败；TP5/TP6中调用toArray()等方法使$list变为数组而丢失分页信息；需检查变量值、类型及query参数传递。
分页 HTML 为空（$show 或 $list->render() 输出空字符串），基本就是分页对象没生成成功，或被意外“解包”了。
为什么 $show 是空字符串（TP3/TP5）
最常见原因是构造 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->render() 返回空（TP5/TP6）
根本原因：你拿到的 $list 已不是 Paginator 实例，而是数组或 Collection。只要中间调过 toArray()、all()、foreach 或 json_encode()，分页元信息就丢了。
- 确认控制器中分页调用后没接任何转换方法：
$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()仍可输出但逻辑异常
分页链接丢失 year/cat 等筛选参数
现象是点下一页后回到第一页数据，URL 里只剩 ?page=2，其他条件全没了——这不是分页失效，是 query 没传对。
立即学习“PHP免费学习笔记（深入）”；
- 必须显式把影响查询的参数塞进
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 条
大数据量下 render() 不显示页码（其实是性能兜底）
当查百万级数据时，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 和耗时
真正卡住人的往往不是语法，而是「以为传了参数，其实没传进去」或者「以为还是 Paginator，其实已经是数组」——每次怀疑分页失效，先 dump 出 $list 的类型和结构，比猜快得多。
