WooCommerce后台订单列表多订单号搜索代码问题排查

问题背景 #

需要在WooCommerce后台订单列表中通过|分隔的多个订单号进行搜索，编写的代码中get_posts($args)能返回正确结果，但后台订单列表无法展示对应结果，怀疑$query_vars['post__in'][] = $post->ID的写法存在问题。

问题分析 #

1. 直接通过get_posts获取结果再赋值给post__in的方式，会因为后台订单列表的默认查询逻辑（保留了s搜索参数）导致post__in的条件被覆盖，WordPress会优先执行默认的搜索查询而非我们指定的ID筛选。
2. 额外执行get_posts会增加一次数据库查询，造成不必要的性能损耗。

修复方案 #

方案1：直接修改查询的meta_query并清空搜索参数 #

不需要额外查询，直接将自定义的meta_query注入到查询变量中，同时清空s参数，让WordPress使用我们的条件进行查询：

function woo_multiple_order_search( $query_vars ) {
    global $typenow, $pagenow;

    if ( 'shop_order' === $typenow && isset( $_GET['s'] ) && 'edit.php' === $pagenow ) {
        $search_term = sanitize_text_field( $_GET['s'] );
        
        // 没有|分隔符则返回原查询
        if ( strpos($search_term, '|') === false ) {
            return $query_vars;
        }
        
        $order_ids = array_filter(explode('|', $search_term)); // 过滤空值
        if ( empty($order_ids) ) {
            return $query_vars;
        }

        // 构建meta_query
        $meta_query = array(
            'relation' => 'OR'
        );
        foreach($order_ids as $order_id) {
            $meta_query[] = array(
                'key'     => '_order_number',
                'value'   => trim($order_id),
                'compare' => '='
            );
        }

        // 替换查询变量中的meta_query，清空搜索参数避免默认搜索干扰
        $query_vars['meta_query'] = $meta_query;
        unset($query_vars['s']); // 移除默认搜索关键词
        // 确保订单状态兼容后台筛选
        if ( !isset($query_vars['post_status']) ) {
            $query_vars['post_status'] = 'any';
        }
    }
    return $query_vars;
}
add_filter( 'request', 'woo_multiple_order_search', 20 );

方案2：用WPDB直接获取Post ID并设置post__in #

如果需要用post__in，可以直接通过WPDB查询获取对应订单号的Post ID，同时清空s参数：

function woo_multiple_order_search( $query_vars ) {
    global $typenow, $pagenow, $wpdb;

    if ( 'shop_order' === $typenow && isset( $_GET['s'] ) && 'edit.php' === $pagenow ) {
        $search_term = sanitize_text_field( $_GET['s'] );
        
        if ( strpos($search_term, '|') === false ) {
            return $query_vars;
        }
        
        $order_ids = array_filter(array_map('trim', explode('|', $search_term)));
        if ( empty($order_ids) ) {
            return $query_vars;
        }

        // 用WPDB查询获取对应的post ID
        $placeholders = implode(', ', array_fill(0, count($order_ids), '%s'));
        $post_ids = $wpdb->get_col(
            $wpdb->prepare(
                "SELECT post_id FROM {$wpdb->postmeta} WHERE meta_key = '_order_number' AND meta_value IN ($placeholders)",
                $order_ids
            )
        );

        if ( empty($post_ids) ) {
            return $query_vars;
        }

        // 设置post__in并清空搜索参数
        $query_vars['post__in'] = $post_ids;
        unset($query_vars['s']);
        if ( !isset($query_vars['post_status']) ) {
            $query_vars['post_status'] = 'any';
        }
    }
    return $query_vars;
}
add_filter( 'request', 'woo_multiple_order_search', 20 );

关键修复点 #

• 移除了多余的get_posts查询，减少数据库压力
• 清空了s参数，避免WordPress执行默认的全文搜索覆盖我们的筛选条件
• 对分割后的订单号做了空值过滤和去空格处理，提升鲁棒性

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