WordPress自定义查询分页异常：仅显示至第17页（共21页）求助

可能的原因 #

1. WooCommerce默认过滤未纳入查询逻辑
   WooCommerce会自动过滤掉不在售、缺货或未发布的产品，但你的自定义查询没有明确包含这些过滤条件，导致实际返回的产品数量比预期少，max_num_pages计算值被拉低（21页是总产品数，17页是符合过滤条件的产品数）。

2. $args重复定义导致潜在冲突
   在分类页判断中，你直接重写了整个$args数组，而非在原有基础上追加tax_query参数，虽然逻辑上能运行，但可能丢失全局钩子对$args的修改，或引发参数覆盖问题。

3. 分页参数处理不严谨
   部分页面场景下（如静态首页），WordPress使用page而非paged作为分页参数，当前代码仅处理paged，可能导致分页参数读取错误。

4. 查询缓存或插件干扰
   WordPress或第三方插件的缓存机制可能存储了旧的分页数据；产品过滤、SEO类插件也可能修改查询逻辑，导致分页计算异常。

解决方法 #

1. 完善WooCommerce产品过滤条件 #

在自定义查询的$args中添加WooCommerce默认的产品状态过滤，确保只返回符合要求的在售产品：

$args = array(
    'post_type'      => 'product',
    'posts_per_page' => 12,
    'paged'          => $paged,
    'post_status'    => 'publish', // 仅显示已发布产品
    'meta_query'     => array(
        array(
            'key'     => '_stock_status',
            'value'   => 'instock',
            'compare' => '='
        )
    )
);

如果需要包含缺货产品，可移除meta_query部分。

2. 修改$args的定义方式 #

在分类页判断中，不要重写整个$args，而是追加tax_query参数，避免参数丢失：

if ($term instanceof WP_Term && 'product_cat' === $term->taxonomy) {
    $args['tax_query'] = array(
        array(
            'taxonomy' => 'product_cat',
            'field'    => 'slug',
            'terms'    => $term->slug,
        ),
    );
}

3. 优化分页参数读取逻辑 #

兼容paged和page两种参数场景，确保分页参数正确获取：

$paged = (get_query_var('paged')) ? get_query_var('paged') : (get_query_var('page') ? get_query_var('page') : 1);

4. 手动验证分页总数并替换 #

直接计算分页总数，避免依赖$query->max_num_pages的自动计算：

// 在WP_Query之后添加
$total_posts = $query->found_posts;
$max_pages = ceil($total_posts / 12); // 12是每页产品数

// 分页输出时替换total参数
echo paginate_links( array(
    'base' => str_replace( $big, '%#%', esc_url( get_pagenum_link( $big ) ) ),
    'format' => '?paged=%#%',
    'current' => max( 1, $paged ), // 用之前定义的$paged变量
    'total' => $max_pages
) );

5. 清除缓存并排查插件干扰 #

• 清除WordPress缓存、WooCommerce缓存及第三方缓存插件的缓存；
• 暂时禁用产品过滤、SEO类插件，测试分页是否恢复正常，逐步排查出干扰插件。

6. 改用WooCommerce官方查询函数（可选） #

使用wc_get_products替代WP_Query，更贴合WooCommerce的产品查询逻辑，避免遗漏核心过滤：

$args = array(
    'status' => 'publish',
    'limit' => 12,
    'page' => $paged,
);
if ($term instanceof WP_Term && 'product_cat' === $term->taxonomy) {
    $args['category'] = array($term->slug);
}
$products = wc_get_products($args);
// 后续产品循环需适配wc_get_products的返回结果
// 分页总数计算：$total_products = wc_get_products(array_merge($args, array('limit' => -1, 'return' => 'ids'))); $max_pages = ceil(count($total_products)/12);

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