本文从 Obsidian 撰写发布
问题现象
- 首页、标签页、最近文章列表的分页均正常
- 唯独分类页点击分页后,地址栏不变,内容始终停留在第一页
- 手动在分类地址后加
-2.html(模仿标签格式)会报错:Path '/cate-xxx-2.html' not found - 手动访问
分类地址?page=2可以正常显示第二页,说明分类查询本身没问题,问题出在分页链接生成环节
原因分析
- Typecho 核心
pageNav()在分类页上下文中生成分页链接存在缺陷:拼接 URL 时未正确附加页码参数,导致所有分页按钮指向第一页或错误地址。该问题在后续版本中才被修复,Typecho 1.2 不包含此修复。 - 分类分页不能套用标签的
-页码.html格式:tag-xxx-2.html能工作是因为路由对 tag 有专门匹配,分类没有对应的-页码.html路由,强行套用会 404。 $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 入口文件天然支持解析),因此稳定可靠。