WordPress分类页带查询参数分页跳转404问题求助

核心问题 #

你遇到的分页404，本质是WordPress的主查询未识别自定义筛选参数，分页时仍按原始分类条件计算，导致无匹配文章触发404。此外query_posts会干扰主查询的分页逻辑，不建议使用。

解决方案步骤 #

1. 确认查询变量注册并刷新重写规则 #

你在functions.php中的变量注册代码没问题，但需要手动刷新一次重写规则：进入后台「设置→固定链接」，随便修改一个选项保存，再改回原设置即可完成刷新。

2. 用pre_get_posts修改主查询（替代query_posts） #

删除category.php里的自定义查询代码，改用钩子在主查询运行前修改参数，让主查询带上筛选条件，保证分页逻辑正常工作。

在functions.php添加以下代码：

add_action('pre_get_posts', 'custom_category_filter_query');
function custom_category_filter_query($query) {
    // 仅在前端分类页的主查询生效
    if (!is_admin() && $query->is_main_query() && is_category()) {
        $title = get_query_var('title');
        $genre = get_query_var('genre');
        $region = get_query_var('region');
        $console = get_query_var('console');
        $top = get_query_var('top');
        
        $meta_query = array('relation' => 'AND');
        
        // 处理标题筛选（如果是自定义字段搜索，替换下方注释内的代码）
        if (!empty($title)) {
            $query->set('s', $title); // 默认标题搜索用`s`参数
            // 自定义字段标题搜索示例：
            // $meta_query[] = array(
            //     'key' => 'custom_title', // 你的自定义字段名
            //     'value' => $title,
            //     'compare' => 'LIKE'
            // );
        }
        
        // 处理各自定义字段筛选
        if (!empty($genre)) {
            $meta_query[] = array(
                'key' => 'genre',
                'value' => $genre,
                'compare' => '='
            );
        }
        if (!empty($region)) {
            $meta_query[] = array(
                'key' => 'region',
                'value' => $region,
                'compare' => '='
            );
        }
        if (!empty($console)) {
            $meta_query[] = array(
                'key' => 'console',
                'value' => $console,
                'compare' => '='
            );
        }
        
        // 处理top参数（按需求调整排序逻辑）
        if (!empty($top)) {
            $query->set('orderby', 'date');
            $query->set('order', 'DESC');
        }
        
        // 若有筛选条件，将meta_query注入主查询
        if (count($meta_query) > 1) {
            $query->set('meta_query', $meta_query);
        }
    }
}

3. 让分页链接携带筛选参数 #

默认分页函数不会自动带上自定义参数，需手动添加。在category.php的分页代码位置替换为：

$paged = get_query_var('paged') ? get_query_var('paged') : 1;
$pagination_args = array(
    'base' => str_replace(999999999, '%#%', esc_url(get_pagenum_link(999999999))),
    'format' => '?paged=%#%',
    'current' => max(1, $paged),
    'total' => $wp_query->max_num_pages,
    'add_args' => array(
        'title' => get_query_var('title'),
        'genre' => get_query_var('genre'),
        'region' => get_query_var('region'),
        'console' => get_query_var('console'),
        'top' => get_query_var('top')
    )
);
echo paginate_links($pagination_args);

4. 清理旧代码 #

删除category.php中原有的query_posts相关代码，保留主循环即可：

if (have_posts()) :
    while (have_posts()) : the_post();
        // 你的文章展示代码
    endwhile;
    // 上方的分页代码
else :
    echo '<p>No posts found.</p>';
endif;

方案原理 #

• pre_get_posts直接修改主查询，WordPress的分页逻辑会基于修改后的查询计算总页数，不会出现主查询为空导致的404。
• 手动在分页链接中注入自定义参数，保证分页时筛选条件被保留。
• 弃用query_posts，避免破坏主查询的全局状态，防止分页、导航等功能异常。

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