WordPress自定义数字分页显示异常，求排查原因

嘿，我知道你遇到的问题了——这大概率是因为你用了query_posts()搞砸了全局查询，导致分页函数拿不到正确的分页数据。让我一步步帮你修复：

问题根源 #

你用query_posts($args)来修改首页的文章列表，但query_posts是WordPress不推荐使用的函数，它会直接覆盖全局的$wp_query对象，而你的自定义分页函数numeric_posts_nav()完全依赖这个全局对象的分页属性（比如max_num_pages），这就导致分页逻辑和你实际的文章列表不匹配，点击分页链接自然无法正常跳转。

另外，你原来的查询参数里没加paged参数，分页根本不知道当前是第几页，这也是一个关键问题。

修复步骤 #

1. 替换query_posts为WP_Query（推荐的自定义查询方式） #

修改首页的文章列表代码，用WP_Query创建独立的查询对象，这样不会干扰全局查询：

<div class="container mt-80 mb-80">
  <div class="card-columns">
    <?php 
    // 定义查询参数，一定要加上paged参数！
    $custom_args = array(
      'tax_query' => array(
        array(
          'taxonomy' => 'category',
          'terms' => array('portfolio'),
          'field' => 'slug',
          'operator' => 'NOT IN',
        ),
      ),
      'paged' => get_query_var('paged') ? get_query_var('paged') : 1,
    );
    // 创建自定义查询对象
    $custom_query = new WP_Query($custom_args);
    ?>
    <?php while($custom_query->have_posts()) : $custom_query->the_post(); ?>
      <div class="card">
        <div class="card-body">
          <a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>">
            <?php the_post_thumbnail('full', array('class' => 'image-post card-img-top')); ?>
          </a>
          <h3 class="card-title"><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h3>
          <p class="card-text"><?php echo get_the_excerpt(); ?> ...</p>
          <span class="entry-date"><?php echo get_the_date(); ?></span>
        </div>
      </div>
    <?php endwhile; wp_reset_postdata(); ?> <!-- 这里要用wp_reset_postdata()恢复全局文章数据 -->
  </div>
  <!-- 调用分页函数时传入自定义查询对象 -->
  <?php numeric_posts_nav($custom_query); ?>
</div>

2. 修改分页函数，支持自定义查询对象 #

原来的分页函数只认全局$wp_query，我们需要让它可以接受自定义的查询参数，这样才能对应你的文章列表：

function numeric_posts_nav($query = null) {
  // 如果没传自定义查询，就用全局$wp_query（兼容原来的使用场景）
  if (is_null($query)) {
    global $wp_query;
    $query = $wp_query;
  }

  // 单页文章不需要分页，直接返回
  if( is_singular() ) return;

  // 如果只有1页，也不需要显示分页
  if( $query->max_num_pages <= 1 ) return;

  $paged = get_query_var( 'paged' ) ? absint( get_query_var( 'paged' ) ) : 1;
  $max = intval( $query->max_num_pages );

  // 构建要显示的页码数组
  $links = [];
  if ( $paged >= 1 ) $links[] = $paged;
  if ( $paged >= 3 ) {
    $links[] = $paged - 1;
    $links[] = $paged - 2;
  }
  if ( ( $paged + 2 ) <= $max ) {
    $links[] = $paged + 2;
    $links[] = $paged + 1;
  }

  echo '<div class="navigation"><ul>' . "\n";

  // 上一页链接
  if ( get_previous_posts_link('', $query) ) {
    printf( '<li>%s</li>' . "\n", get_previous_posts_link('上一页', $query) );
  }

  // 第一页链接（加省略号）
  if ( ! in_array( 1, $links ) ) {
    $class = 1 == $paged ? ' class="active"' : '';
    printf( '<li%s><a href="%s">%s</a></li>' . "\n", $class, esc_url( get_pagenum_link( 1 ) ), '1' );
    if ( ! in_array( 2, $links ) ) echo '<li>…</li>';
  }

  // 中间页码
  sort( $links );
  foreach ( (array) $links as $link ) {
    $class = $paged == $link ? ' class="active"' : '';
    printf( '<li%s><a href="%s">%s</a></li>' . "\n", $class, esc_url( get_pagenum_link( $link ) ), $link );
  }

  // 最后一页链接（加省略号）
  if ( ! in_array( $max, $links ) ) {
    if ( ! in_array( $max - 1, $links ) ) echo '<li>…</li>' . "\n";
    $class = $paged == $max ? ' class="active"' : '';
    printf( '<li%s><a href="%s">%s</a></li>' . "\n", $class, esc_url( get_pagenum_link( $max ) ), $max );
  }

  // 下一页链接
  if ( get_next_posts_link('', $query) ) {
    printf( '<li>%s</li>' . "\n", get_next_posts_link('下一页', $query) );
  }

  echo '</ul></div>' . "\n";
}

为什么这样修改就有效？ #

• WP_Query创建的是独立的查询对象，不会破坏全局的$wp_query，分页函数可以通过传入这个对象获取正确的总页数和分页数据。
• 我们给查询参数加上了paged，让WordPress能识别当前的页码，分页链接跳转后才能加载对应的文章列表。
• 修改后的分页函数既兼容原来的全局查询场景，又支持自定义查询，灵活性更高。

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