WordPress自定义taxonomy根归档页访问报404错误如何解决

WordPress 原生路由规则没有给自定义分类法（taxonomy）分配独立的根归档页解析逻辑，默认的taxonomy-{taxonomy}.php模板仅会匹配「具体分类项」的请求：

• 访问/taxonomy-test/sub-test时，系统能识别到是请求test分类法下slug为sub-test的具体项，所以正常加载模板
• 直接访问/taxonomy-test/时，系统找不到对应路由匹配规则，直接返回404，这不是配置遗漏，是核心默认逻辑导致的。

1. 注册根路径路由与查询变量 #

将以下代码加入当前主题的functions.php文件，接管分类法根路径的请求：

// 为test分类法注册根路径重写规则
add_action('init', function () {
    add_rewrite_rule(
        '^taxonomy-test/?$',
        'index.php?taxonomy_root=test',
        'top'
    );
});

// 注册自定义查询参数，供后续模板判断使用
add_filter('query_vars', function ($vars) {
    $vars[] = 'taxonomy_root';
    return $vars;
});

如果你注册test分类法时自定义了rewrite['slug']，请把规则里的taxonomy-test替换为你实际使用的路径slug。

2. 绑定根路径模板 #

添加模板加载钩子，让根路径请求直接加载你已经创建好的taxonomy-test.php模板：

// 路由匹配时加载对应模板
add_filter('template_include', function ($template) {
    if (get_query_var('taxonomy_root') === 'test') {
        $custom_tpl = locate_template(['taxonomy-test.php']);
        return $custom_tpl ?: $template;
    }
    return $template;
});

3. 刷新重写规则 #

进入WordPress后台，打开「设置」→「固定链接」页面，无需修改任何配置，直接点击底部「保存更改」，系统会自动更新重写规则缓存，此时访问/taxonomy-test/就不会再返回404。

4. 模板内区分根页面与子项页逻辑 #

在taxonomy-test.php中通过查询变量判断当前请求类型，分别输出对应内容：

<?php
if (get_query_var('taxonomy_root') === 'test') {
    // 根页面逻辑：输出热门子分类链接
    $hot_sub_terms = get_terms([
        'taxonomy' => 'test',
        'parent' => 0,
        'hide_empty' => true,
        'orderby' => 'count', // 按关联文章数排序，即热门度
        'order' => 'DESC',
        'number' => 10 // 取前10个热门子分类，可自行调整数量
    ]);

    if (!is_wp_error($hot_sub_terms) && !empty($hot_sub_terms)) {
        echo '<div class="test-tax-root">';
        echo '<h2>热门子分类</h2>';
        echo '<ul class="sub-term-list">';
        foreach ($hot_sub_terms as $term) {
            printf(
                '<li><a href="%s">%s（%d）</a></li>',
                esc_url(get_term_link($term)),
                esc_html($term->name),
                $term->count
            );
        }
        echo '</ul>';
        echo '</div>';
    }
} else {
    // 原有子分类项页面逻辑：展示当前sub-test项的相关数据
    // 这里保留你之前写好的子分类页内容代码即可
}
?>

• 不推荐使用重定向方案：重定向会产生额外的HTTP请求，对SEO不友好，上述方案走WP原生路由解析流程，和系统内置页面的加载逻辑完全一致
• 不要修改WP核心文件：所有规则通过官方提供的钩子注册，升级核心、切换主题（如果代码放在子主题里）都不会失效
• 如果后续修改了分类法slug，记得重新保存一次固定链接刷新规则

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