WordPress自定义文章类型与分类URL冲突致404问题求助

你遇到的404是因为WordPress无法区分industries/父分类/文章别名这种URL到底是要访问分类归档还是单篇文章——自定义文章类型和分类的重写slug都是industries，WP默认规则会优先判定这种结构为分类层级，找不到对应内容就返回404。

1. 调整自定义文章类型注册代码 #

注册industry自定义文章类型时，明确重写规则的属性，让WP识别这是文章 permalink 结构：

function register_industry_cpt() {
    $args = array(
        'labels' => array(
            'name' => 'Industries',
            'singular_name' => 'Industry'
        ),
        'public' => true,
        'has_archive' => true,
        'rewrite' => array(
            'slug' => 'industries',
            'with_front' => false,
            'ep_mask' => EP_PERMALINK
        ),
        'supports' => array('title', 'editor', 'thumbnail'),
        'taxonomies' => array('industry_category')
    );
    register_post_type('industry', $args);
}
add_action('init', 'register_industry_cpt');

2. 调整自定义分类注册代码 #

注册关联的层级分类时，确保支持层级URL结构：

function register_industry_taxonomy() {
    $args = array(
        'labels' => array(
            'name' => 'Industry Categories',
            'singular_name' => 'Industry Category'
        ),
        'hierarchical' => true,
        'public' => true,
        'rewrite' => array(
            'slug' => 'industries',
            'with_front' => false,
            'hierarchical' => true
        )
    );
    register_taxonomy('industry_category', 'industry', $args);
}
add_action('init', 'register_industry_taxonomy');

3. 添加自定义重写规则 #

添加优先级更高的重写规则，强制WP将industries/父分类/文章别名结构解析为单篇文章：

// 注册自定义查询变量
function add_industry_query_var($vars) {
    $vars[] = 'industry_post_slug';
    return $vars;
}
add_filter('query_vars', 'add_industry_query_var');

// 添加匹配规则
function add_industry_rewrite_rule() {
    add_rewrite_rule(
        '^industries/([^/]+)/([^/]+)/?$',
        'index.php?post_type=industry&name=$matches[2]',
        'top'
    );
}
add_action('init', 'add_industry_rewrite_rule');

4. 处理 fallback 场景（可选） #

如果存在二级分类的URL和文章URL结构冲突，添加代码让WP在找不到文章时自动 fallback 到分类查询：

function fix_industry_404($query) {
    if (!is_admin() && $query->is_main_query() && $query->get('post_type') == 'industry' && !$query->get_queried_object()) {
        $category_slug = $query->get('name');
        $category = get_term_by('slug', $category_slug, 'industry_category');
        if ($category) {
            $query->set('post_type', '');
            $query->set('industry_category', $category_slug);
        }
    }
    return $query;
}
add_action('pre_get_posts', 'fix_industry_404');

5. 刷新重写规则 #

进入WordPress后台「设置」→「固定链接」，无需修改任何选项，直接点击「保存更改」，让新的重写规则生效。

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