WooCommerce产品库与默认商店页面产品数量不匹配问题求助

问题现象 #

后台产品库显示总数超350个，但商店页面仅显示270个。尝试以下操作后结果仍为270个：

1. 用WP_Query直接查询所有已发布产品
2. 通过pre_get_posts钩子修改商店页面主查询，设置posts_per_page=-1
3. 直接执行SQL查询

已尝试代码 #

$args = array(
    'post_type'      => 'product',
    'post_status'    => 'publish',
    'posts_per_page' => -1, // 获取全部产品
);

$products = new WP_Query( $args );
$i=0;
if ( $products->have_posts() ) {
    while ( $products->have_posts() ) {
        $products->the_post();
        $i++;
    }   
    echo 'Product—sum：'.$i;
}

function show_all_products_on_shop_page($query) {
    if (is_admin() || ! $query->is_main_query()) {
        return;
    }

    if (is_shop()) {
        $query->set('posts_per_page', -1);
    }
}
add_action('pre_get_posts', 'show_all_products_on_shop_page');

相关截图 #

• 后台产品统计截图：
  
• 商店页面显示截图：
  

排查方向 #

• 核对产品状态：后台统计包含草稿、私有、待审核等所有状态的产品，切换后台产品列表筛选条件为「已发布」，查看数量是否和前台一致
• 检查产品类型过滤：若产品包含可变产品的子变体，默认WP_Query不会查询product_variation类型，可修改post_type参数为array('product', 'product_variation')测试；同时排查是否有自定义产品类型被过滤
• 排查查询钩子：检查主题或其他插件是否通过pre_get_posts、posts_where、woocommerce_product_query等钩子修改了查询条件，比如排除特定分类、标签，或过滤库存状态
• 检查库存设置：进入WooCommerce后台→设置→产品→库存，确认是否开启「隐藏缺货产品」，该选项会让缺货的已发布产品不显示在前台
• 验证SQL逻辑：执行以下SQL语句（替换你的数据库表前缀）：

SELECT COUNT(ID) FROM wp_posts WHERE post_type='product' AND post_status='publish';

若结果为270，说明后台统计包含了非发布状态的产品；若结果大于270，继续查询是否有元数据过滤：

SELECT COUNT(p.ID) FROM wp_posts p 
LEFT JOIN wp_postmeta pm ON p.ID = pm.post_id 
WHERE p.post_type='product' AND p.post_status='publish'
AND (pm.meta_key='_stock_status' AND pm.meta_value='instock')

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