在WordPress中拦截404请求并根据自定义字段重定向至对应文章

嘿，这个思路真的很务实！用template_redirect钩子来拦截404请求并匹配旧URL跳转，完全是合适的解决方案，我帮你把具体的实现细节和注意事项理清楚：

template_redirect的优势在于它会在WordPress确定要渲染哪个模板之前触发，刚好能在404页面加载前介入处理跳转。下面是可直接复用的代码，你可以把它放到主题的functions.php文件里，或者封装成一个简单的自定义插件：

add_action('template_redirect', function() {
    // 只对404请求进行处理，避免干扰正常页面加载
    if (!is_404()) {
        return;
    }

    // 获取当前请求的路径部分（比如 "/old-listing-page.html"）
    // 如果你的old_website_url字段存的是完整域名+路径，就改用下面这行：
    // $requested_url = esc_url_raw($_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI']);
    $requested_url = esc_url_raw($_SERVER['REQUEST_URI']);

    // 精准查询匹配old_website_url字段的listings_cpt文章
    $matching_post = new WP_Query([
        'post_type'      => 'listings_cpt',
        'post_status'    => 'publish',
        'meta_query'     => [
            [
                'key'     => 'old_website_url',
                'value'   => $requested_url,
                'compare' => '=',
            ]
        ],
        'posts_per_page' => 1,
        'no_found_rows'  => true, // 关闭结果计数，提升查询性能
        'fields'         => 'ids', // 只返回文章ID，减少数据传输
    ]);

    // 找到匹配文章就执行301永久重定向（对SEO最友好）
    if ($matching_post->have_posts()) {
        $post_id = $matching_post->posts[0];
        $new_permalink = get_permalink($post_id);
        
        wp_redirect($new_permalink, 301);
        exit; // 必须退出，避免后续代码执行
    }

    // 没找到匹配项，继续走正常的404流程
});

• 性能优化：因为你的站点有1000+页面，建议给old_website_url这个自定义字段添加数据库索引——可以用自定义字段管理插件的专业版，或者手动执行SQL语句添加索引，这样能大幅提升查询速度。
• 字段格式统一：确保old_website_url里存储的URL格式和请求的URL完全一致，比如是否带开头的斜杠、是否包含域名、大小写是否统一，避免因为格式差异导致匹配失败。
• 测试验证：先在测试环境验证跳转逻辑，重点检查：旧URL是否能正确跳转到对应的新页面、非匹配URL是否正常显示404、有没有出现循环跳转的情况。
• 扩展兼容：如果除了listings_cpt还有其他类型的页面需要跳转，可以修改post_type参数为数组（比如['listings_cpt', 'page', 'post']），或者添加多个meta_query规则来适配不同字段。

内容的提问来源于stack exchange，提问作者Rui Silva Luís