WordPress自定义页面分页与重写规则异常问题

我之前也碰到过类似的情况，核心问题就是无筛选参数时，WordPress的默认分页规则和你的自定义查询没有正确对接，下面一步步帮你解决：

1. 确保自定义查询正确捕获分页参数 #

首先检查你创建WP_Query时的参数，不管有没有筛选条件，都要确保paged参数是从WordPress的查询变量里获取，而不是直接读$_GET。因为无筛选时，分页页码是通过重写后的URL传递的，不是GET参数：

// 获取当前页码，默认值为1
$paged = get_query_var('paged', 1);

// 构建查询参数
$args = array(
    'post_type'      => 'post',
    'posts_per_page' => 10,
    'paged'          => $paged, // 关键：把分页参数传入查询
    'post_status'    => isset($_GET['status']) ? sanitize_text_field($_GET['status']) : 'publish',
    'author'         => get_current_user_id() // 假设你要展示当前用户的帖子
);

$user_posts_query = new WP_Query($args);

2. 补充无筛选条件的重写规则 #

你已经配置了带筛选的重写规则，但缺了无筛选时的分页规则。假设你的自定义页面slug是user-posts，添加下面的规则：

function custom_user_posts_rewrite_rules() {
    // 已有的带筛选条件的分页规则
    add_rewrite_rule(
        'user-posts/status/([^/]+)/page/([0-9]+)/?$',
        'index.php?pagename=user-posts&status=$matches[1]&paged=$matches[2]',
        'top'
    );
    
    // 新增：无筛选条件的分页规则
    add_rewrite_rule(
        'user-posts/page/([0-9]+)/?$',
        'index.php?pagename=user-posts&paged=$matches[1]',
        'top'
    );
}
add_action('init', 'custom_user_posts_rewrite_rules');

添加完后，一定要去WordPress后台的设置 → 固定链接页面，点击「保存更改」刷新重写规则，否则新规则不会生效。

3. 分页函数要绑定自定义查询的分页数据 #

用paginate_links()生成分页链接时，要确保它使用的是你的自定义查询$user_posts_query的分页数据，而不是全局的$wp_query：

if ($user_posts_query->max_num_pages > 1) {
    echo paginate_links(array(
        'base'      => get_pagenum_link(1) . '%_%',
        'format'    => '/page/%#%',
        'current'   => max(1, $paged),
        'total'     => $user_posts_query->max_num_pages,
        // 有筛选参数时自动带上，无筛选时则不添加
        'add_args'  => isset($_GET['status']) ? array('status' => sanitize_text_field($_GET['status'])) : false
    ));
}

4. 避免全局查询干扰 #

在自定义查询循环结束后，一定要调用wp_reset_postdata()恢复全局查询，防止后续的WordPress函数（包括分页相关）读取错误的查询数据：

if ($user_posts_query->have_posts()) {
    while ($user_posts_query->have_posts()) {
        $user_posts_query->the_post();
        // 这里写你的帖子内容展示代码
    }
    
    // 分页代码放在这里
    
    wp_reset_postdata(); // 必须添加，恢复全局查询状态
}

总结 #

这几个步骤下来，无筛选条件时的分页应该就能正常工作了。核心就是让WordPress在无筛选时也能正确识别分页参数，并传递给你的自定义查询，同时分页链接要匹配重写规则生成正确的URL。

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