thinkphp 6 分页参数丢失的修复方法是调用 paginate() 后使用 appends() 追加除 page 外的 get 参数,避免模板重复处理,确保分页链接携带完整查询条件。

ThinkPHP 6 分页时参数丢失,通常是因为 paginate() 方法默认只保留当前 URL 的路径(path),而忽略了查询参数(如搜索关键词、分类 ID、排序字段等)。修复核心是手动合并当前请求的 GET 参数到分页链接中。
确保分页链接携带原始查询参数
在控制器中调用 paginate() 后,使用 appends() 方法把当前请求的所有 GET 参数追加进去:
$list = Db::name('article')
->where($where)
->order('create_time desc')
->paginate(10);
// 将当前所有 GET 参数(除 page 外)自动附加到分页链接
$list->appends(request()->except('page'));
这样生成的上一页/下一页链接就会包含 ?keyword=xxx&category=2&page=2 这类完整参数。
避免重复追加导致参数混乱
如果多次调用 appends() 或在模板中又手动传参,可能造成参数重复。建议统一在控制器处理,并确保只执行一次:
- 不要在模板里用
{$list->render|raw}前再调用appends() - 若需过滤某些参数(如敏感或临时参数),可用
request()->only(['keyword', 'category', 'sort']) - 注意:TP6.1+ 中
paginate()返回的是LengthAwarePaginator实例,支持链式调用
自定义分页器(可选,适合全局统一处理)
如项目中大量用到分页且参数较固定,可创建一个封装方法:
function safe_paginate($query, $per_page = 15) {
$page = input('page/d', 1);
$params = request()->except(['page']);
return $query->paginate($per_page, false, ['page' => $page])
->appends($params);
}
// 使用
$list = safe_paginate(Db::name('user')->where($where), 10);
模板中正确渲染(不额外干预)
模板中直接输出即可,无需手动拼接参数:
<div class="pagination">
{$list->render()|raw}
</div>
TP6 的分页器会自动把 appends() 的数据注入到每一页的链接 href 中。
关键点就三个:调用 appends()、传入非 page 的 GET 参数、不在模板里重复处理。不复杂但容易忽略。











