WordPress移除分层CPT slug后子文章链接失效的解决求助

嘿，我之前也踩过这个坑！当你把CPT的slug从URL里去掉后，WordPress的默认重写规则根本搞不清那些带层级的URL到底是属于CPT的子文章还是普通页面，所以才会出现子链接打不开的情况。我给你一套完整的解决方案，亲测有效：

1. 完善permalink生成函数，支持多级子文章 #

你现有的rewrite_permalink函数只处理了单级文章的URL，得修改它来保留子文章的层级结构，同时去掉父级的CPT slug：

function custom_cpt_remove_slug_permalink($permalink, $post_id, $leavename) {
    $post = get_post($post_id);
    // 这里替换成你实际的自定义文章类型slug
    $target_cpt = 'your-cpt-slug';

    // 只处理目标CPT的文章
    if (empty($post) || $post->post_type !== $target_cpt) {
        return $permalink;
    }

    // 递归拼接父级文章的slug，生成层级路径
    $parent_path = '';
    $current_parent_id = $post->post_parent;
    while ($current_parent_id) {
        $parent_post = get_post($current_parent_id);
        // 只拼接同类型CPT的父文章
        if ($parent_post->post_type === $target_cpt) {
            $parent_path = $parent_post->post_name . '/' . $parent_path;
        }
        $current_parent_id = $parent_post->post_parent;
    }

    // 组装最终的URL：根目录 + 父级路径 + 当前文章slug
    $permalink = home_url('/' . $parent_path . $post->post_name . '/');
    return $permalink;
}
add_filter('post_type_link', 'custom_cpt_remove_slug_permalink', 10, 3);

2. 添加自定义重写规则，让WordPress识别多级URL #

光生成正确的URL还不够，得告诉WordPress怎么解析这些层级URL，找到对应的CPT文章：

function custom_cpt_rewrite_rules() {
    $target_cpt = 'your-cpt-slug';
    // 匹配1级子文章（比如 /parent-post/child-post/）
    add_rewrite_rule(
        '^([^/]+)/([^/]+)/?$',
        'index.php?post_type=' . $target_cpt . '&name=$matches[2]',
        'top'
    );
    // 匹配2级子文章（比如 /parent-post/child-post/grandchild-post/）
    add_rewrite_rule(
        '^([^/]+)/([^/]+)/([^/]+)/?$',
        'index.php?post_type=' . $target_cpt . '&name=$matches[3]',
        'top'
    );
    // 如果需要支持更多层级，可以继续添加类似规则，或者用更通用的正则
    // 通用正则（匹配任意层级）：'^(.+)/([^/]+)/?$' 但要注意和页面URL的冲突问题
}
add_action('init', 'custom_cpt_rewrite_rules');

3. 处理查询冲突，优先匹配CPT文章 #

因为现在CPT的URL结构和普通页面、文章可能重叠，得让WordPress优先检查这些URL是否属于我们的CPT：

function custom_cpt_query_priority($query) {
    $target_cpt = 'your-cpt-slug';
    // 只处理前台的主查询
    if (!is_admin() && $query->is_main_query() && isset($query->query['name'])) {
        // 尝试用路径匹配CPT文章
        $target_post = get_page_by_path($query->query['name'], OBJECT, $target_cpt);
        if ($target_post) {
            // 如果找到匹配的CPT文章，强制设置查询类型为该CPT
            $query->set('post_type', $target_cpt);
        }
    }
    return $query;
}
add_action('pre_get_posts', 'custom_cpt_query_priority');

4. 关键步骤：刷新重写规则 #

做完以上修改后，一定要登录WordPress后台，进入设置 → 固定链接页面，随便选择一个固定链接格式（不用改，保持原来的就行），然后点击“保存更改”。这一步会刷新WordPress的重写规则，让我们的新规则生效。

注意事项 #

• 记得把代码里的your-cpt-slug替换成你实际使用的自定义文章类型slug
• 如果你的网站有大量页面，可能需要调整正则规则，避免CPT子文章和页面URL冲突（比如可以给CPT文章设置独特的命名前缀）
• 测试所有层级的子文章链接，确保每个都能正确打开对应的内容

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