WordPress 博客分页从第3页开始出现404错误的解决方案-php教程-PHP中文网

WordPress 博客分页从第3页开始出现404错误的解决方案

本文详解 WordPress 自定义分页逻辑导致第3页起返回404 的根本原因——动态 posts_per_page 与分页参数冲突，以及 offset 误用、post_type 混淆等常见陷阱，并提供安全、可复用的修复代码与最佳实践。

本文详解 wordpress 自定义分页逻辑导致第3页起返回404 的根本原因——动态 `posts_per_page` 与分页参数冲突，以及 `offset` 误用、`post_type` 混淆等常见陷阱，并提供安全、可复用的修复代码与最佳实践。

造成“博客分页从第3页开始返回404”的核心问题，并非服务器配置或固定链接刷新失败，而是当前查询逻辑违反了 WordPress 分页机制的基本约束：paged 参数必须与恒定的 posts_per_page 值协同工作。您代码中使用了动态分页数：

$posts_per_page = is_paged() ? 6 : 7;

这会导致严重后果：

首页（paged=1）显示7篇；
第2页（paged=2）显示6篇 → 此时 WordPress 计算第2页起始位置为第8篇（7+1）；
但第3页（paged=3）期望从第14篇开始（7+6+1），而实际数据库中可能尚未达到该偏移量，且因每页数量不一致，WP_Query 无法正确推导总页数与URL路由映射，最终触发404。

⚠️ 特别注意：答案中提到的 'offset' => 3 并非本问题的解法——它会跳过前3篇文章，彻底破坏分页连续性（例如第1页显示第4–10篇，第2页显示第11–16篇），且与 paged 参数冲突，绝对不可用于标准分页场景。同理，将 post_type 改为 'page' 属于概念混淆：您的需求是博客文章（post）分页，而非页面（page）列表。

WordPress API Pro

生产级WordPress REST API集成，用于管理文章、页面、媒体、WooCommerce产品、Elementor内容、SEO元数据、ACF及JetEngine字段

下载

✅ 正确解决方案是统一每页文章数，并通过 pre_get_posts 钩子在主循环前修正查询（推荐），或在自定义查询中严格保持 posts_per_page 恒定：

@php
// ✅ 正确做法：固定每页数量（如7篇）
$paged = get_query_var('paged') ?: 1;
$args = [
  'post_type'      => 'post',
  'posts_per_page' => 7, // ← 必须固定！
  'paged'          => $paged,
];

if ($category) {
  $args['tax_query'] = [[
    'taxonomy' => 'category',
    'field'    => 'slug',
    'terms'    => $category->slug,
  ]];
}

if ($search) {
  $args['s'] = $search;
}

$blog_query = new WP_Query($args);
@endphp

<!-- 循环输出 -->
@if ($blog_query->have_posts())
  @while ($blog_query->have_posts()) @php $blog_query->the_post(); @endphp
    <article><h2>{{ get_the_title() }}</h2>
      {{ the_excerpt() }}
    </article>
  @endwhile

  <!-- 分页导航（需配合主题分页函数或自定义） -->
  <div class="pagination">
    {{ the_posts_pagination([
      'mid_size'  => 2,
      'prev_text' => __('« Previous'),
      'next_text' => __('Next »'),
    ]) }}
  </div>

  @php wp_reset_postdata(); @endphp
@endif

? 关键注意事项：

永远不要在分页查询中动态修改 posts_per_page —— 这是404的直接元凶；
若需首页展示更多文章（如首屏7篇、后续每页6篇），应使用 WP_Query 单独查首页 + pre_get_posts 调整主循环，或采用「首页+分页」双查询模式，而非同一查询混用；
修改后务必刷新固定链接（设置 → 固定链接 → 保存更改），确保重写规则更新；
使用 WP_Query 时，切记调用 wp_reset_postdata() 避免影响后续主循环。

遵循以上原则，即可彻底解决第3页起404问题，实现稳定、SEO友好的博客分页。