WooCommerce同名分类商品显示异常问题求助

开发者阿泽

2026-8-18

WooCommerce跨路径同名分类商品显示异常解决方案

问题原因

你遇到的问题大概率由以下两点导致：

同名分类slug重复：WordPress默认要求分类slug唯一，若手动将Store->Girl和Baby->Girl的slug都设为girl，会导致归档页查询混淆，加载所有slug匹配的分类商品。
默认查询逻辑特性：WooCommerce产品分类归档页默认会包含当前分类及其所有子分类的商品，若分类层级设置有误（比如误将Baby->Girl设为Store->Girl的子分类），也会出现跨分类显示问题。

解决方法

1. 修复分类slug唯一性

进入后台产品 > 分类
分别编辑Store->Girl和Baby->Girl分类：
- 给Store->Girl设置唯一slug，比如store-girl
- 给Baby->Girl设置唯一slug，比如baby-girl
更新分类后，重新访问归档页测试。

2. 强制分类归档仅显示当前分类的直接商品

如果slug没问题，但仍出现跨分类显示，可通过代码修改查询逻辑，让归档页只匹配当前分类的term_id，不包含任何子分类或同名分类的商品：

将以下代码添加到主题（或子主题）的functions.php文件中：

add_action( 'pre_get_posts', 'restrict_product_category_to_current_term' );
function restrict_product_category_to_current_term( $query ) {
    if ( ! is_admin() && $query->is_main_query() && is_product_category() ) {
        $current_term = get_queried_object();
        // 仅匹配当前分类的term_id，禁用子分类包含
        $query->set( 'tax_query', array(
            array(
                'taxonomy' => 'product_cat',
                'field'    => 'term_id',
                'terms'    => $current_term->term_id,
                'include_children' => false,
            )
        ) );
    }
}