WordPress使用add_rewrite_rule实现WooCommerce筛选美化URL不生效如何解决？

核心错误修正 #

你当前的重写规则存在两处底层逻辑错误，直接导致规则不生效：

• 重写目标的参数拼接错误：index.php 后所有查询参数需用&分隔，不能额外加?
• 路径匹配规则遗漏前缀：你要匹配的路径是/products/cars/[分类]，不是根目录下的/cars/[分类]，且你声明的%cars%重写标签未被实际使用，可以删除

修正后的基础重写代码如下：

add_action('init', 'myplugin_rewrite_tag_rule', 10, 0);
function myplugin_rewrite_tag_rule() {
    add_rewrite_rule(
        'products/cars/([^/]*)/?$',
        'index.php?pagename=cars&yith_wcan=1&product_cat=$matches[1]',
        'top'
    );
}

生效校验与兼容处理 #

修改代码后按以下步骤操作排查：

• 再次刷新固定链接配置：进入WP后台→设置→固定链接，直接点击「保存设置」即可，无需修改现有配置
• 验证查询变量是否被正确识别：在cars页面模板的顶部加入测试代码，访问/products/cars/red/查看输出：

  var_dump(get_query_var('product_cat'), get_query_var('yith_wcan'));
  

  正常输出应为string(3) "red" string(1) "1"
• 适配YITH插件的参数读取逻辑：部分版本的YITH筛选插件会优先读取全局$_GET参数而非WP原生查询变量，需额外添加钩子注入参数：

  add_action('template_redirect', 'inject_yith_filter_params');
  function inject_yith_filter_params() {
      if (get_query_var('pagename') === 'cars' && get_query_var('product_cat')) {
          $_GET['yith_wcan'] = get_query_var('yith_wcan');
          $_GET['product_cat'] = get_query_var('product_cat');
      }
  }
  

冲突排查 #

如果以上操作后仍未生效，按以下步骤排查：

• 确认站点固定链接不是「朴素」模式，必须使用任意带路径结构的固定链接配置
• 临时禁用其他带有重写功能的插件、主题自带的自定义重写逻辑，排查是否存在规则优先级冲突
• 可安装重写规则检测类工具，确认你添加的规则是否位于规则列表最顶部，是否有其他规则提前匹配了/products/cars/开头的路径

可选优化：让插件直接输出美化URL #

无需跳转，直接让插件生成的筛选链接默认就是美化格式，添加以下钩子即可：

add_filter('yith_wcan_filter_url', 'customize_yith_filter_url', 10, 2);
function customize_yith_filter_url($url, $filter_data) {
    if (str_contains($url, 'product_cat=') && str_contains($url, '/products/cars/')) {
        parse_str(parse_url($url, PHP_URL_QUERY), $params);
        if (isset($params['product_cat'])) {
            $url = home_url('/products/cars/' . sanitize_title($params['product_cat']) . '/');
        }
    }
    return $url;
}

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