Woocommerce的product_query中meta_query不生效，如何通过URL参数筛选商品？

常见失效原因及对应解决方法 #

• 查询条件未加范围限制，导致钩子触发场景不对
  现有代码没有限制仅在前台商品归档页的主查询生效，会作用于所有调用woocommerce_product_query的场景（包括后台、侧边栏商品小工具等），容易被其他逻辑覆盖，需要追加查询判断条件。
• 直接覆盖meta_query导致和其他逻辑冲突
  直接用$q->set('meta_query', xxx)会清空原有查询的所有meta条件（比如商品是否上架、库存筛选等默认规则，还有其他插件/主题加的筛选条件），正确做法是先获取原有meta_query再追加你的筛选条件。
• ACF字段值类型不匹配
  如果你ACF里book_age_group字段设置的是数字类型，URL参数传的23是字符串格式，比较时会因为类型不一致匹配失败，需要把参数值转为对应类型。
• 缓存未清理
  WooCommerce默认会缓存商品归档查询结果，修改代码后需要清空全站缓存（页面缓存、对象缓存、WooCommerce transient缓存）才能生效。
• 自定义字段key不匹配
  确认ACF中设置的字段名确实是book_age_group，可以用代码echo get_post_meta( 商品ID, 'book_age_group', true );输出对应商品的字段值，校验key和存储值是否符合预期。

修正后的代码 #

function updateQueryByAgeFilter( $q ){ 
    // 仅在前台商品归档页的主查询生效，排除后台、其他小工具查询
    if ( ! is_admin() && $q->is_main_query() && is_shop() && isset($_GET['filterbyAge']) ) {
        // 获取原有meta_query，不存在则初始化空数组
        $meta_query = $q->get( 'meta_query' ) ?: [];
        // 追加年龄筛选条件
        $meta_query[] = [
            'key' => 'book_age_group',
            'value' => intval($_GET['filterbyAge']), // 如果字段存储的是字符串格式，去掉intval即可
            'compare' => '='
        ];
        // 把合并后的meta_query设置回查询
        $q->set('meta_query', $meta_query);
    }
}
add_action( 'woocommerce_product_query', 'updateQueryByAgeFilter' );

排查调试方法 #

如果修改后仍不生效，可以临时加调试逻辑，确认钩子是否触发、参数是否正确获取：

// 临时调试代码，排查完成后删除
add_action('wp_head', function(){
    if(isset($_GET['filterbyAge'])){
        var_dump($_GET['filterbyAge']);
        global $wp_query;
        var_dump($wp_query->get('meta_query'));
    }
});

访问带参数的商店页，看是否输出了对应的参数和meta_query配置，确认代码是否正常执行。

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