三股水
Typecho 1.2 分类页分页失效问题解决教程
本文从 Obsidian 撰写发布

问题现象

  • 首页、标签页、最近文章列表的分页均正常
  • 唯独分类页点击分页后,地址栏不变,内容始终停留在第一页
  • 手动在分类地址后加 -2.html(模仿标签格式)会报错:Path '/cate-xxx-2.html' not found
  • 手动访问 分类地址?page=2 可以正常显示第二页,说明分类查询本身没问题,问题出在分页链接生成环节

原因分析

  1. Typecho 核心 pageNav() 在分类页上下文中生成分页链接存在缺陷:拼接 URL 时未正确附加页码参数,导致所有分页按钮指向第一页或错误地址。该问题在后续版本中才被修复,Typecho 1.2 不包含此修复。
  2. 分类分页不能套用标签的 -页码.html 格式:tag-xxx-2.html 能工作是因为路由对 tag 有专门匹配,分类没有对应的 -页码.html 路由,强行套用会 404。
  3. $this->permalink 在分类页上下文中不可靠:直接用它拼分页链接,可能拿到的是当前第一篇文章的地址,导致点击页码跳到文章详情页。

解决方案

放弃在分类页使用 $this->pageNav(),改为仅对分类页手写分页逻辑,使用已验证可用的 ?page=N 查询参数格式。其他页面(首页、标签、最近文章列表)继续使用原来的 $this->pageNav(),完全不受影响。

关键点

  • 分类页基础地址用 strtok($this->request->getRequestUri(), '?') 获取当前请求路径,不要用 $this->permalink
  • 链接格式:第一页用干净地址,第 N 页用 基础地址?page=N
  • 输出的 HTML 结构必须与 pageNav() 一致,避免影响现有 CSS:

    • 上一页:<li class="prev"><a>‹</a></li>
    • 下一页:<li class="next"><a>›</a></li>
    • 当前页:<li class="active"><a href="...">N</a></li>
    • 省略号:<li><span>...</span></li>
    • 普通页码:<li><a href="...">N</a></li>
    • 外层:<ul class="flex gap-x-5">

完整代码

将主题模板中原来的分页代码($this->pageNav(...) 部分)替换为以下内容。外层 div、nav 等结构保持原样:

<?php if (!defined("__TYPECHO_ROOT_DIR__")) {
  exit();
} ?>

<div class="flex justify-center">
    <div class="bg-block"></div>
    <nav aria-label="Page navigation" id="page-nav">
        <?php if ($this->is('category')): ?>
            <?php
            // 仅分类页:手写分页,使用 ?page=N 格式,结构与 pageNav 输出保持一致
            $currentPage = $this->getCurrentPage();
            $totalPages  = ceil($this->getTotal() / $this->parameter->pageSize);

            if ($totalPages > 1) {
                // 关键:用当前请求路径作为分类基础地址,去掉已有查询串
                $baseUrl = strtok($this->request->getRequestUri(), '?');

                echo '<ul class="flex gap-x-5">';

                // 上一页
                if ($currentPage > 1) {
                    $prev = ($currentPage - 1 == 1) ? $baseUrl : $baseUrl . '?page=' . ($currentPage - 1);
                    echo '<li class="prev"><a href="' . $prev . '">‹</a></li>';
                }

                $start = max(1, $currentPage - 1);
                $end   = min($totalPages, $currentPage + 1);

                if ($start > 1) {
                    echo '<li><a href="' . $baseUrl . '">1</a></li>';
                    if ($start > 2) echo '<li><span>...</span></li>';
                }

                for ($i = $start; $i <= $end; $i++) {
                    if ($i == $currentPage) {
                        echo '<li class="active"><a href="' . $baseUrl . '?page=' . $i . '">' . $i . '</a></li>';
                    } else {
                        $link = ($i == 1) ? $baseUrl : $baseUrl . '?page=' . $i;
                        echo '<li><a href="' . $link . '">' . $i . '</a></li>';
                    }
                }

                if ($end < $totalPages) {
                    if ($end < $totalPages - 1) echo '<li><span>...</span></li>';
                    echo '<li><a href="' . $baseUrl . '?page=' . $totalPages . '">' . $totalPages . '</a></li>';
                }

                // 下一页
                if ($currentPage < $totalPages) {
                    echo '<li class="next"><a href="' . $baseUrl . '?page=' . ($currentPage + 1) . '">›</a></li>';
                }

                echo '</ul>';
            }
            ?>
        <?php else: ?>
            <?php $this->pageNav("‹", "›", 1, "...", [
              "wrapTag" => "ul",
              "wrapClass" => "flex gap-x-5",
              "itemTag" => "li",
              "currentClass" => "active",
            ]); ?>
        <?php endif; ?>
    </nav>
</div>

验证步骤

替换模板代码后保存
清理浏览器缓存(或用无痕窗口)
进入任意分类页,点击分页数字
确认地址栏变为 分类地址?page=N,内容正确切换
确认标签页、首页、最近文章列表的分页仍然正常
确认分页区域的样式与之前一致(结构已对齐,CSS 无需改动)

为什么之前正常后来又不行

Typecho 1.2 的分类分页链接生成本身依赖核心 pageNav() 的脆弱逻辑,在某些 URL 格式或路由条件下可能“碰巧”工作。一旦主题调整、伪静态变动或核心状态变化,就会退回到有缺陷的状态。手写分页绕开了核心生成逻辑,直接使用标准的 ?page=N 查询参数(Typecho 入口文件天然支持解析),因此稳定可靠。

评论加载中...