WordPress 主题中自定义分页逻辑时，因 posts_per_page 动态变化导致分页参数与 WordPress 重写规则不兼容，引发第3页起的404错误；根本原因在于混合使用了非标准分页逻辑与默认主查询冲突。
wordpress 主题中自定义分页逻辑时，因 `posts_per_page` 动态变化导致分页参数与 wordpress 重写规则不兼容，引发第3页起的404错误；根本原因在于混合使用了非标准分页逻辑与默认主查询冲突。
该问题并非由“查询页面（page）”或“误用 offset”引起（答案中关于 'post_type' => 'page' 和 'offset' => 3 的建议属于典型误判——原代码明确用于博客文章列表，且 offset 会彻底破坏分页的连续性，禁用 offset 是 WordPress 分页最佳实践的铁律），而是源于一个关键矛盾：动态改变每页文章数（第1页7篇、其余页6篇）违反了 WordPress 分页机制对固定 posts_per_page 的依赖。
WordPress 的分页重写规则（如 /page/3/）和内部 WP_Query 分页计算均假设每页条目数恒定。当第1页显示7篇、第2页起改为6篇时，系统按统一 posts_per_page=6 推算总页数，但实际第1页已占用7个位置，导致后续页码偏移错乱。例如：共20篇文章时，正确分页应为 7+6+6+1 → 共4页；但 WordPress 按 6 计算会认为需 ⌈20/6⌉ = 4 页，而第3页请求 /page/3/ 实际对应数据库中第13–18条记录——但由于第1页多占1条，真实第3页内容（第14–19条）已超出预期范围，最终触发 404。
✅ 正确解法是保持 posts_per_page 全局一致，并通过 CSS 或模板逻辑单独处理首页样式：
@php
// 统一每页显示6篇文章（推荐值，可按需调整）
$posts_per_page = 6;
$paged = get_query_var('paged') ? get_query_var('paged') : 1;
$args = [
'post_type' => 'post',
'posts_per_page' => $posts_per_page,
'paged' => $paged,
];
if ($category) {
$args['tax_query'] = [[
'taxonomy' => 'category',
'field' => 'slug',
'terms' => $category->slug,
]];
}
if ($search) {
$args['s'] = $search;
}
$custom_query = new WP_Query($args);
@endphp
<!-- 在循环中通过 $custom_query->current_post 判断是否首页首条 -->
@while ($custom_query->have_posts())
@php $custom_query->the_post(); @endphp
<article class="{{ $custom_query->current_post === 0 && $paged === 1 ? 'featured-home' : '' }}"><h2>{{ get_the_title() }}</h2>
{{ the_excerpt() }}
</article>
@endwhile
<!-- 分页导航（务必使用自定义查询对象） -->
{{ the_posts_pagination([
'total' => $custom_query->max_num_pages,
'mid_size' => 2,
'prev_text' => '← 上一页',
'next_text' => '下一页 →',
]) }}
@php wp_reset_postdata(); @endphp
⚠️ 关键注意事项：
- 切勿在分页查询中使用 offset：它会跳过指定数量文章，导致分页完全失效（如 /page/2/ 将跳过前6篇再取6篇，而非取第2页应有的第7–12篇）；
- 避免修改主查询（$wp_query）后未重置：若在 index.php 等主模板中覆盖主查询，必须调用 wp_reset_query() 或 wp_reset_postdata()；
- 刷新重写规则：修改分页逻辑后，进入「设置 → 固定链接」点击「保存更改」以刷新 .htaccess 或 Nginx 重写规则；
- 验证分页 URL 结构：确保站点未启用「静态首页」，且博客页面为真正的 home.php 或 index.php，而非自定义页面模板。
总结：WordPress 分页的健壮性建立在「每页条目数恒定」前提之上。牺牲首页展示灵活性换取分页可靠性，是专业主题开发的共识方案——用前端样式差异化呈现首页内容，而非用后端逻辑破坏分页根基。
