WordPress自定义WP_Query调用全局时max_num_pages返回0故障求助

问题根因 #

• 自定义WP_Query参数配置错误：你设置了no_found_rows => true，该参数的作用是跳过总匹配文章数计算逻辑，专门用于不需要分页的查询场景以提升性能，开启后查询不会生成总页数数据，自然无法返回正确的max_num_pages。
• 分页函数未指定自定义查询对象：next_posts_link()、previous_posts_link()默认读取全局主查询$wp_query的分页参数，你自定义的$documentQuery分页数据不会被默认识别，全局主查询的max_num_pages为0，导致分页渲染失败。
• 缺失当前页码参数：自定义查询未传入paged参数，无法识别当前访问的分页页码，每次只会返回第一页的内容。

修复方案 #

1. 修改自定义查询代码 #

删除no_found_rows参数，新增paged参数获取当前页码：

return new WP_Query(
    array(
        'post_type' => 'dokumente',
        'post__in' => $documentIds,
        'posts_per_page' => 10,
        'paged' => get_query_var('paged') ? get_query_var('paged') : 1,
    )
);

2. 修改页面渲染代码 #

给分页函数传入自定义查询的总页数，循环结束后调用wp_reset_postdata()重置全局文章变量，避免变量污染：

if ($documentQuery->have_posts()) {
    while ($documentQuery->have_posts()) : $documentQuery->the_post();
        $document = $post;
        // 此处保留你原有单篇文章的渲染逻辑
    endwhile;
?>
<div class="nav-previous alignleft"><?php next_posts_link('Older posts', $documentQuery->max_num_pages); ?></div>
<div class="nav-next alignright"><?php previous_posts_link('Newer posts', $documentQuery->max_num_pages); ?></div>
<?php
    wp_reset_postdata();
}

你原来循环里写的global $wp_query、global $post没有必要，the_post()已经自动完成了当前文章对象的赋值，没有修改全局主查询的需求可以直接删掉这两行全局声明。

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