WordPress搜索URL添加post_type参数遇无限循环问题求助

原代码的问题分析 #

1. site_url过滤器误用：这个过滤器的作用是修改site_url()函数的返回值，并非处理当前请求的跳转逻辑。每次WordPress生成站点URL时都会触发该函数，结合JS跳转就会导致无限循环。
2. 参数判断逻辑不严谨：用字符串匹配&post_type=product无法覆盖所有场景，比如参数是URL中的第一个参数（格式为?post_type=product）时，判断会失效，导致重复添加。
3. JS跳转的缺陷：跳转后未终止PHP执行，页面后续内容仍会输出，且跳转后的URL会再次触发相同代码逻辑，陷入循环。

推荐解决方案（无需跳转，直接修改查询） #

使用pre_get_posts钩子在查询执行前修改参数，这是WordPress官方推荐的方式，高效且无跳转体验问题：

add_action('pre_get_posts', 'modify_search_post_type');
function modify_search_post_type($query) {
    // 仅处理前台主查询、搜索请求，且未指定post_type参数的情况
    if ( !is_admin() && $query->is_main_query() && $query->is_search() && !isset($query->query_vars['post_type']) ) {
        $query->set('post_type', 'product');
    }
}

说明：

• 直接修改查询变量，无需跳转，用户体验更流畅。
• 仅在未指定post_type时添加参数，避免重复。
• 限制为前台主查询，不会影响后台或其他自定义查询。

备选方案（URL跳转方式，不推荐） #

如果一定要通过URL跳转实现，使用template_redirect钩子处理，正确解析URL参数并避免循环：

add_action('template_redirect', 'redirect_search_to_product');
function redirect_search_to_product() {
    // 检查是否为搜索请求，且未携带post_type参数
    if ( is_search() && !isset($_GET['post_type']) ) {
        // 用WordPress内置函数构建新URL，自动处理参数拼接逻辑
        $new_url = add_query_arg(
            array('post_type' => 'product'),
            get_search_link()
        );
        // 301永久重定向，避免浏览器缓存旧URL导致循环
        wp_redirect($new_url, 301);
        exit; // 终止PHP执行，防止后续内容输出
    }
}

说明：

• 使用add_query_arg和get_search_link确保URL拼接的正确性，避免手动拼接字符串的错误。
• exit语句终止后续代码执行，防止跳转后页面内容继续输出。
• 301重定向有助于SEO，同时避免重复跳转循环。

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