Phalcon分页需统一分页参数名：控制器用自定义键读取（如p），Paginator构造时仍传page键，视图链接手动替换参数名；GET分页须携带搜索参数，用http_build_query动态拼接；嵌套路由应使用命名路由和url->get()生成链接；调试时检查请求参数是否被中间件拦截。
Phalcon 的 Paginator 默认使用 page 作为当前页码参数名，但实际项目中常需适配已有路由规范（如用 p、offset 或带前缀的 posts[page]），此时若直接修改 URL 拼接逻辑却忽略内部参数解析机制，就会导致分页跳转失效或始终停留在第一页——本质是控制器读取参数与视图生成链接不一致。
确认并统一分页参数名
Phalcon 不会自动识别你自定义的 URL 参数名，必须在控制器和视图两端显式指定：
- 控制器中读取时，明确使用你约定的键名，例如：
$curPage = $this->request->getQuery('p', 'int', 1); - 构造 Paginator 时仍按原逻辑传入
page键，因为适配器只认这个键：new Paginator(['data' => $posts, 'limit' => 10, 'page' => $curPage]) - 视图中生成翻页链接时，不能依赖默认的
$page->before等属性直接拼?page=...，而要手动替换为你的参数名，例如：$this->tag->linkTo("posts/index?p=" . $page->before, "上一页")
避免 URL 参数污染（GET/POST 混合场景）
当页面同时支持搜索表单（POST）和分页链接（GET）时，容易出现参数覆盖或丢失。比如用户提交搜索后点击“下一页”，链接里没带上搜索关键词，结果查出全量数据。
- 推荐做法：所有分页链接统一走 GET，并把搜索条件也作为查询参数携带，例如
/posts/index?p=2&keyword=phalcon&category=docs - 控制器中获取分页参数前，先收集其他必要参数：
$queryParams = $this->request->getQuery(); $curPage = $queryParams['p'] ?? 1; - 视图中生成链接时，用
http_build_query()动态拼接完整参数，而非硬编码：$params = array_merge($queryParams, ['p' => $page->next]); $this->tag->linkTo('posts/index?' . http_build_query($params), '下一页')
处理嵌套路由或模块化路径
若应用使用了模块（Module）、命名空间或 REST 风格路径（如 /api/v1/posts），默认的 $this->tag->linkTo() 可能生成错误路径，导致分页链接 404。
- 不要写死路径字符串，改用
$this->url->get()构建完整 URL：$this->url->get(['for' => 'posts-index', 'p' => $page->next]) - 提前在
Router中为分页路由定义命名路由（named route），例如：$router->add('/posts/{p:[0-9]+}', ['controller' => 'posts', 'action' => 'index'])->setName('posts-index'); - 这样即使路径结构变化，视图层只需改路由名，无需动所有链接逻辑
调试分页参数传递是否生效
常见问题不是代码写错，而是参数根本没传进来或被中间件拦截。
- 在控制器开头加日志：
error_log('Received page param: ' . print_r($this->request->getQuery(), true)); - 检查是否启用了全局过滤器（如 CSRF 验证、JSON 解析中间件）意外吞掉了 GET 参数
- 用浏览器开发者工具 Network 标签查看分页链接发出的请求 URL，确认参数名和值是否符合预期
- 注意 Phalcon 3.x 和 4+/5+ 版本中
Request::getQuery()对空值、数组参数的处理差异，必要时加filter显式转换
