WooCommerce产品与分类URL基础相同引发404问题求助

我太懂这个坑了！很多人在配置WooCommerce固定链接时都会踩这个——当你想让产品分类（比如www.example.com/products/product-category）和单个产品（www.example.com/products/sample-product）共用products作为URL基础时，WordPress的重写规则优先级会搞事情：分类的规则会先被匹配，导致所有单个产品的请求都被误判为分类，直接返回404。

下面给你两个靠谱的解决方案，都是我帮开发者踩过坑后验证有效的：

方案1：调整重写规则优先级（推荐） #

这个方法不用改分类的基础URL，直接通过代码修改规则顺序，让产品的请求先被识别。

• 把这段代码加到你的主题functions.php（或者自定义插件里更安全，避免主题更新丢失代码）：

function custom_product_rewrite_rules() {
    global $wp_rewrite;
    // 先移除WooCommerce默认的重写规则，避免冲突
    remove_filter('rewrite_rules_array', 'woocommerce_rewrite_rules');
    
    // 把单个产品的规则放在最前面，优先级最高
    add_rewrite_rule('^products/([^/]+)/?$', 'index.php?product=$matches[1]', 'top');
    
    // 再添加产品分类的规则，包括分页场景
    add_rewrite_rule('^products/([^/]+)/page/([0-9]+)/?$', 'index.php?product_cat=$matches[1]&paged=$matches[2]', 'top');
    add_rewrite_rule('^products/([^/]+)/?$', 'index.php?product_cat=$matches[1]', 'top');
    
    // 刷新重写规则
    $wp_rewrite->flush_rules(false);
}
add_action('init', 'custom_product_rewrite_rules');

• 操作最后一步很关键：登录WordPress后台，进入「设置」→「固定链接」，不用改任何设置，直接点「保存更改」，手动触发重写规则刷新。

方案2：修复分类别名重写的遗留问题 #

你提到的用foo作为分类基础再重写的方法，问题通常出在分类的规范URL还是显示foo、内部跳转异常。用下面的代码可以彻底修复：

1. 先去固定链接设置里，把产品分类基础设为foo
2. 然后添加这段代码到functions.php：

// 把分类的前端显示URL从/foo/改成/products/
function custom_product_cat_permalink($permalink, $term, $taxonomy) {
    if ($taxonomy === 'product_cat') {
        $permalink = str_replace('/foo/', '/products/', $permalink);
    }
    return $permalink;
}
add_filter('term_link', 'custom_product_cat_permalink', 10, 3);

// 让WordPress正确识别/products/开头的分类请求
function custom_product_cat_rewrite($query) {
    if (!is_admin() && $query->is_main_query() && isset($query->query_vars['product_cat'])) {
        if (strpos($_SERVER['REQUEST_URI'], '/products/') === 0) {
            $query->query_vars['product_cat'] = $query->query_vars['product_cat'];
        }
    }
    return $query;
}
add_action('pre_get_posts', 'custom_product_cat_rewrite');

// 修复规范URL，避免搜索引擎收录/foo/版本
function custom_product_cat_canonical($canonical) {
    if (is_product_category()) {
        $canonical = str_replace('/foo/', '/products/', $canonical);
    }
    return $canonical;
}
add_filter('wpseo_canonical', 'custom_product_cat_canonical'); // 适配Yoast SEO
add_filter('rel_canonical', 'custom_product_cat_canonical'); // 适配WordPress默认规范URL

最后提醒 #

• 确保你的服务器支持重写：Apache要开启mod_rewrite，Nginx要配置try_files规则
• 测试前清空浏览器缓存和网站缓存插件的缓存
• 用自定义插件存代码比主题functions.php更稳妥，避免主题更新丢失改动

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