woocommerce_product_query钩子在WooCommerce商品分类页面不生效如何解决

核心原因分析 #

你遇到的分类页筛选失效、查询仅返回固定ID集合的问题，绝大多数是分类页存在提前预查询商品ID的逻辑，直接设置了post__in参数覆盖了默认查询，导致你加的meta_query条件没有被触发执行。

分步排查 #

• 先确认woocommerce_product_query钩子在分类页是否触发：在你的函数第一行加入日志写入代码，访问分类页查看日志是否生成，即可判断钩子有没有被执行。
• 检查主题/插件的预查询逻辑：常见的缺货商品隐藏、自定义分类过滤功能、页面构建器的商品模块，都会提前查询符合条件的商品ID，直接赋值给查询的post__in参数，后续的meta条件会被忽略。
• 检查钩子优先级：你当前使用默认的10优先级，若有其他功能更早修改了查询参数，你的修改会被覆盖。

修复代码 #

将你原有的代码替换为以下版本，做了优先级调整、安全过滤、主查询判断，还增加了可选的post__in清空逻辑：

add_action( 'woocommerce_product_query', 'custom_meta_filter', 99 );
function custom_meta_filter( $q ){ 
    // 仅对主查询、且存在指定URL参数时生效
    if ( ! $q->is_main_query() || ! isset( $_GET['my_custom_key'] ) ) {
        return;
    }
    $meta_query = $q->get( 'meta_query' );
    $meta_query[] = array(
        'key'     => 'my_custom_key',
        'value'   => sanitize_text_field( $_GET['my_custom_key'] ),
        'compare' => '='
    );  
    $q->set( 'meta_query', $meta_query );
    
    // 若确认是post__in参数导致过滤失效，可取消下面一行的注释
    // $q->set( 'post__in', array() );
}

额外排查项 #

如果修改代码后仍然失效，按以下顺序排查：

1. 关闭WooCommerce后台「隐藏缺货商品」选项测试，该功能会提前预过滤商品ID
2. 切换为WooCommerce默认主题Storefront测试，排除主题自定义模板的问题
3. 逐一禁用商品过滤、缓存、页面构建类插件，定位冲突插件

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