WP Query分页无法显示求助：如何实现数字分页？

一、分页函数的放置位置 #

• 两种方式都可行：
  • 推荐放主题的functions.php中，方便所有模板全局调用；
  • 若仅单个模板需要，也可直接写在对应模板文件（如archive.php、自定义模板custom-post-list.php）内。

二、可直接复用的数字分页实现代码 #

1. 模板文件中的自定义查询代码 #

// 获取当前页码，首页默认是1
$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;

// 自定义WP Query参数
$args = array(
    'post_type'      => 'post', // 替换为你的自定义文章类型
    'posts_per_page' => 6,      // 每页显示文章数量
    'paged'          => $paged, // 核心：传入当前页码
    'post_status'    => 'publish'
);
$custom_query = new WP_Query($args);

// 循环输出文章
if ($custom_query->have_posts()) :
    while ($custom_query->have_posts()) : $custom_query->the_post();
        // 替换为你的文章内容模板
        the_title('<h3 class="post-title">', '</h3>');
        the_excerpt();
    endwhile;

    // 调用分页函数
    custom_pagination($custom_query);

    // 重置查询，避免干扰全局查询逻辑
    wp_reset_postdata();
else :
    echo '<p>暂无相关内容</p>';
endif;

2. 分页函数（放functions.php或模板文件末尾） #

function custom_pagination($query) {
    $big = 999999999; // 用于替换URL中的占位页码

    $paginate_links = paginate_links(array(
        'base'      => str_replace($big, '%#%', esc_url(get_pagenum_link($big))),
        'format'    => '?paged=%#%',
        'current'   => max(1, get_query_var('paged')),
        'total'     => $query->max_num_pages, // 核心：使用自定义查询的总页数
        'prev_text' => '« 上一页',
        'next_text' => '下一页 »',
        'type'      => 'list' // 输出为ul列表，方便CSS样式定制
    ));

    if ($paginate_links) {
        echo '<div class="pagination-wrap">';
        echo $paginate_links;
        echo '</div>';
    }
}

三、常见失效原因排查 #

• 未传入paged参数：WP Query必须配置'paged' => $paged，否则无法识别当前页码；
• 混淆全局查询与自定义查询：分页函数必须接收自定义查询对象$custom_query，不能直接用全局的$wp_query（除非是修改主查询）；
• 未重置查询：循环结束后必须调用wp_reset_postdata()，否则会破坏后续的全局查询逻辑；
• 固定链接冲突：前往后台「设置-固定链接」，避免使用「朴素」模式，推荐选「文章名」模式，否则分页URL可能解析错误。

四、503错误的解决思路 #

第三种代码触发503，大概率是以下问题：

• 无限循环：检查分页函数是否存在错误的递归调用或循环逻辑；
• 内存耗尽：可临时在wp-config.php中提高内存限制：define('WP_MEMORY_LIMIT', '256M');；
• 语法错误：排查代码是否有括号不匹配、缺少分号等低级错误，这类问题会直接导致PHP解析失败。

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