ThinkPHP中paginate()分页参数未生效是因默认只识别page和list_rows，可通过显式传参、全局配置paginate.php、路由变量注入、appends()追加或setParam()覆盖五种方式解决。
如果您在 ThinkPHP 中调用 paginate() 方法后分页参数未生效，例如 URL 中使用 ?p=2 或 ?size=20 却始终返回第 1 页、默认条数，则很可能是因框架默认仅识别 page 和 list_rows 这两个 GET 参数名。以下是配置分页参数的多种可行方式：
一、在 paginate() 调用时显式传入参数配置
此方法适用于单次查询定制，不改变全局行为，优先级最高，可覆盖默认参数解析逻辑。
1、在控制器中使用 input() 显式提取自定义参数，并传入 paginate() 的第三个参数配置数组。
2、确保第二个参数设为 false，防止框架重复自动解析 URL 参数导致冲突。
立即学习“PHP免费学习笔记（深入）”；
3、示例代码：UserModel::paginate(15, false, ['page' => input('p/d', 1), 'list_rows' => input('size/d', 15)])。
4、若需保留搜索条件（如 keyword），同时追加 query 配置：['query' => ['p' => input('p'), 'size' => input('size'), 'keyword' => input('keyword')]]。
二、全局配置 paginate.php 文件
此方法适用于全站统一参数命名规则，避免各处重复写 input() 提取逻辑，TP6.1+ 版本正式支持该配置项。
1、在 config/paginate.php 文件中返回配置数组（若不存在则新建）。
2、设置 'page' => 'p' 和 'list_rows' => 'size'，使框架自动从 ?p=2&size=20 中读取。
3、确认配置已加载：可通过 config('paginate.page') 输出验证是否返回 'p'。
4、注意：此配置仅影响自动参数解析，不改变 paginate() 第一个参数（每页条数）的含义；若第一个参数为整数，仍会作为 list_rows 使用，与配置不冲突。
三、通过 URL 路由变量传递并手动注入
当采用路由模式如 /list/p/2/size/20 时，框架默认不会将路由变量映射到分页参数，需手动介入。
1、在路由定义中明确绑定变量，例如：Route::get('list/p/:p/size/:size', 'index/list')。
2、在控制器方法参数中接收：public function list($p = 1, $size = 15)。
3、调用 paginate() 时直接传入：UserModel::paginate($size, false, ['page' => (int)$p])。
4、若需保持路由风格链接，还需配置 'url' => request()->url() 或使用 appends() 补充变量，避免翻页后丢失。
四、使用 appends() 动态追加非标准参数
此方法不修改 page 或 list_rows 解析逻辑，而是将额外参数强制附加到所有分页链接中，适用于需透传业务参数的场景。
1、先获取原始分页对象：$list = UserModel::paginate(15)。
2、调用 appends() 方法注入键值对：$list = $list->appends(['p' => input('p'), 'size' => input('size')])。
3、注意：appends() 仅影响生成的 HTML 链接中的 query string，**不参与当前页码或条数计算**，因此必须配合方法一或二使用，否则分页逻辑仍按默认参数执行。
4、可在模板中直接输出：{$list->render()}，链接将包含完整追加参数。
五、通过 setParam() 方法临时覆盖单次请求参数
该方式适用于 API 场景或无法修改 URL 结构时，绕过 GET 解析，直接设定分页上下文。
1、创建分页对象后立即调用 setParam()：$list = UserModel::paginate(15); $list->setParam('page', input('p/d', 1));。
2、同样需设置条数参数：$list->setParam('list_rows', input('size/d', 15))。
3、此操作会修改分页实例内部状态，后续调用 render() 或 currentPage() 均以 setParam 值为准。
4、不可与 appends() 混用同一参数名，否则行为未定义；建议仅用于调试或特殊协议适配。
