WordPress移除顶级URL Slug并正常访问多级子页面求助

核心问题在于：你只做了旧URL（带tournament-name）到新URL的重定向，但WordPress会根据页面的原始固定链接（带父slug）自动反向重定向，导致循环。要解决这个问题，需要同时实现让WordPress识别不带父slug的短URL和安全的重定向逻辑，还要保证SEO规范。

完整解决方案代码 #

将以下代码添加到主题的functions.php文件中，或使用自定义代码插件：

// 添加Rewrite规则，让WordPress识别短URL
function custom_add_rewrite_rules() {
    $parent_slug = 'tournament-name';
    // 匹配所有以非父slug开头的多级路径（支持子页面、孙页面）
    add_rewrite_rule(
        '^(.+)/?$',
        'index.php?pagename=' . $parent_slug . '/$matches[1]',
        'top'
    );
}
add_action('init', 'custom_add_rewrite_rules');

// 修正查询变量，避免WordPress自动重定向回旧URL
function custom_fix_query_vars($query) {
    if (!is_admin() && $query->is_main_query() && isset($query->query_vars['pagename'])) {
        $parent_slug = 'tournament-name';
        $requested_pagename = $query->query_vars['pagename'];
        
        // 检查当前请求的URL是否是短URL（不含父slug）
        global $wp;
        $request_path = $wp->request;
        
        // 如果请求路径不是以父slug开头，但查询变量里的pagename包含父slug，说明是通过Rewrite规则匹配的
        if (strpos($request_path, $parent_slug) !== 0 && strpos($requested_pagename, $parent_slug . '/') === 0) {
            // 取消WordPress的自动重定向
            remove_action('template_redirect', 'redirect_canonical');
            
            // 设置正确的canonical标签，指向短URL（SEO需求）
            add_filter('wpseo_canonical', function() use ($request_path) {
                return home_url($request_path);
            });
            // 如果不使用Yoast SEO，用默认的canonical过滤
            add_filter('get_canonical_url', function() use ($request_path) {
                return home_url($request_path);
            });
        }
    }
    return $query;
}
add_action('pre_get_posts', 'custom_fix_query_vars');

// 处理旧URL（带父slug）到短URL的301重定向
function custom_redirect_old_urls() {
    if (is_admin()) return;
    
    $parent_slug = 'tournament-name';
    global $wp;
    $request_path = $wp->request;
    
    // 检查当前请求路径是否以父slug开头
    if (strpos($request_path, $parent_slug . '/') === 0) {
        // 生成短URL路径
        $new_path = substr($request_path, strlen($parent_slug) + 1);
        $new_url = home_url($new_path);
        
        // 检查是否已经是短URL（避免循环）
        if ($new_url !== home_url($request_path)) {
            wp_redirect($new_url, 301);
            exit;
        }
    }
}
add_action('parse_request', 'custom_redirect_old_urls');

代码说明 #

1. Rewrite规则：

   • 在init钩子中添加顶级Rewrite规则，把所有非父slug开头的请求路径，映射到tournament-name/[请求路径]的页面，让WordPress能找到对应的子/孙页面。
   • 添加规则后需要刷新固定链接设置：进入WordPress后台 → 设置 → 固定链接，直接点击保存即可，不需要修改结构。

2. 取消自动重定向：

   • 在pre_get_posts钩子中，判断当前请求是短URL时，移除WordPress默认的redirect_canonical动作，阻止它跳回带父slug的原始URL。
   • 同时设置canonical标签为短URL，确保搜索引擎只收录优化后的URL，满足SEO需求。

3. 安全重定向旧URL：

   • 在parse_request钩子中，只对带父slug的旧URL做301重定向到短URL，并且添加判断避免循环。

注意事项 #

• 如果你的父页面不止一个，可以把$parent_slug改成数组，循环处理（需要调整Rewrite规则和判断逻辑）。
• 测试时请先在本地环境验证，避免影响线上站点。
• 刷新固定链接是必须的步骤，否则Rewrite规则不会生效。

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