WordPress静态首页分页异常：各页面显示相同文章问题

嘿，这个静态首页分页重复的问题我碰到过好多次啦，本质上大多是WordPress静态首页的分页参数逻辑和普通博客页不一样导致的，咱们一步步来搞定它：

1. 核心问题：分页参数没正确传递给自定义查询 #

WordPress对**静态首页（Front Page）**的分页参数使用的是page，而普通博客列表页用的是paged。如果你的自定义查询没区分这一点，就会导致每次都只加载第一页的内容。

修复方法：正确获取分页参数并传入WP_Query #

在你的静态首页模板（一般是front-page.php）里，替换原来的自定义查询代码：

// 正确获取静态首页的分页参数
$paged = (get_query_var('page')) ? get_query_var('page') : 1;

// 构建自定义查询参数，指定你要展示的分类
$custom_args = array(
    'post_type' => 'post',
    'category_name' => '你的分类别名', // 替换成目标分类的别名（不是名称）
    'posts_per_page' => 6, // 每页显示的文章数量，按需修改
    'paged' => $paged, // 关键：把分页参数传给查询
    'post_status' => 'publish'
);

// 初始化自定义查询
$custom_query = new WP_Query($custom_args);

2. 确保分页链接生成正确 #

用paginate_links()生成分页导航时，也要适配静态首页的URL格式（比如domain.com/page/2/），不然可能跳错页面或者参数不生效：

// 只有当总页数大于1时才显示分页
if ($custom_query->max_num_pages > 1) {
    echo '<div class="pagination">';
    echo paginate_links(array(
        'base' => get_pagenum_link(1) . '%_%', // 基础URL，确保分页链接正确拼接
        'format' => 'page/%#%/', // 静态首页的分页URL格式
        'current' => max(1, $paged), // 当前页码
        'total' => $custom_query->max_num_pages, // 总页数
        'prev_text' => '← 上一页',
        'next_text' => '下一页 →'
    ));
    echo '</div>';
}

3. 别忘了重置查询（关键！） #

自定义查询结束后，一定要调用wp_reset_postdata()，否则会干扰WordPress的主查询逻辑，导致后续内容或分页出现异常：

// 循环输出文章内容
if ($custom_query->have_posts()) :
    while ($custom_query->have_posts()) : $custom_query->the_post();
        // 这里放你的文章模板代码，比如：
        // the_title('<h2>', '</h2>');
        // the_excerpt();
    endwhile;

    // 上面的分页代码放这里

    // 重置查询，恢复主查询的上下文
    wp_reset_postdata();
else :
    echo '<p>暂无该分类的文章</p>';
endif;

4. 排查其他可能的干扰因素 #

如果上面的代码改完还是有问题，检查这几个点：

• 缓存插件：如果用了WP Rocket、W3 Total Cache这类插件，可能缓存了首页内容，导致分页页面显示重复。可以暂时禁用缓存插件测试，或者在缓存设置里排除/page/*路径的缓存。
• 固定链接设置：后台「设置→固定链接」里，确保使用的是“文章名称”或其他非默认的固定链接结构，默认的?page_id=格式可能导致分页参数识别失败。
• 模板文件正确性：确认你修改的是front-page.php（静态首页专用模板），而不是home.php或index.php，别改错文件白忙活。

内容的提问来源于stack exchange，提问作者Ante Medic