paginate() 返回 Collection 而非 Paginator 实例导致 render() 等方法报错，主因是调用 toArray()、all() 或 foreach 导致分页对象“解包”；应保持 $list 为原始 paginate() 结果，模板中使用 {$list->render|raw} 渲染。
为什么 paginate() 返回的数据结构和预期不一致？
直接调用 paginate() 后发现模板里拿不到 $list->render() 或者 $list->lastPage() 报错，大概率是因为你拿到的是一个 Collection 而不是 Paginator 实例。ThinkPHP 6 默认在模型查询链式调用后返回的是 thinkPaginatorSimple（无总条数）或 thinkPaginatorBootstrap（有总条数），但如果你中间用了 toArray()、all() 或 foreach 遍历再赋值，就已“解包”成普通数组，分页对象信息全丢了。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 确保分页变量始终是原始
paginate()调用结果，例如：$list = User::where('status', 1)->paginate(10);，不要接->toArray() - 模板中必须用
{$list->render|raw}（TP6）或{:widget('think\paginator\driver\Bootstrap', $list)}（TP5.1）来渲染页码 HTML - 检查是否开启了「数据集自动转换」：TP6 中若配置了
'collection' => true在数据库配置里，可能干扰分页对象类型，建议设为false
如何自定义 paginate() 的每页数量和当前页参数？
paginate() 默认从 $_GET['page'] 读取当前页，每页 15 条；但实际项目常要改这两个值，且不能硬编码写死——比如后台列表要 20 条/页，API 接口要支持 ?p=2 而非 ?page=2。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 传入整数控制每页条数：
User::paginate(20) - 用数组参数定制行为：
User::paginate(['list_rows'=>20, 'page'=>input('p/d', 1), 'var_page'=>'p'])，其中var_page改变 URL 参数名，page手动指定当前页（避免依赖 GET） - 注意 TP6.3+ 中
list_rows已改为listRows（驼峰），旧写法会静默失效 - 如果用
Db::name('user')->paginate()，参数结构一致，但需确保是查询构造器实例，而非原生 SQL 查询结果
paginate() 在关联查询中丢失分页信息怎么办？
常见于 with('profile') + paginate() 组合：数据能查出来，但 $list->total() 返回 0，或 render() 不显示页码。这是因为 ThinkPHP 对关联预载入的分页做了限制——它只对主表做 COUNT，而关联字段不参与分页计算，但更隐蔽的问题是：如果你在 paginate() 前用了 field() 或 alias()，可能导致 COUNT SQL 生成失败，最终 fallback 到简单分页（无总页数）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 优先用
load()替代with()做懒加载（适合单条详情），避免预载入干扰分页 - 如必须预载入，确保主模型查询未使用
field()限定字段（除非明确写出主表所有分页所需字段，如id,name等） - 手动补 COUNT：先执行
$count = User::where(...)->count()，再用User::where(...)->page(input('page'), 15)->select()拆分逻辑（牺牲一点便利性换可控性） - TP6.2+ 可尝试
paginate(15, false, ['query'=>request()->param()])的第三个参数启用「简单分页」并透传 URL 参数，避免因 COUNT 失败导致分页崩溃
模板里 $list->render() 输出空白或报错？
最常见原因是模板引擎未识别到分页对象的魔术方法，或 HTML 被自动转义。TP6 默认使用 think-template，对 render() 返回的 HTML 字符串默认做了 htmlspecialchars 处理，导致页码标签变成纯文本。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 模板中必须加
|raw过滤器：{$list->render|raw}（TP6）；TP5.1 是{:$list->render|raw} - 确认
$list确实是Paginator实例：在控制器里dump($list instanceof hinkPaginator);，返回true才安全 - 如果用了自定义分页模板（如
theme参数），路径必须正确，且模板文件中不能出现 PHP 语法错误；推荐先删掉theme用默认样式定位问题 - 部分 Nginx + PATH_INFO 配置下，URL 重写会导致
render()生成的链接缺失路由变量，此时应显式传入'query'参数同步当前请求参数
toArray() 调用。 
