WC_Order_Query查询无自定义元字段或元字段值不等于'yes'的订单失败问题

我来帮你搞定这个WooCommerce订单查询的难题，你的核心需求是找出**11-8天前完成、要么没设置x_days_follow_up_email元字段，要么该字段值不等于yes**的订单，之前的问题主要出在元查询的构造逻辑和WC_Order_Query的参数使用上，下面给你针对性的解决方案：

推荐方案：直接使用WC_Order_Query的meta_query参数 #

WC_Order_Query本身支持meta_query参数，不需要额外挂钩动作，直接构造这个参数就能高效实现需求，而且这是WooCommerce官方推荐的查询方式，性能比原生WP_Query更优。

完整代码示例 #

// 构造11-8天前的时间范围（格式符合WooCommerce要求：YYYY-MM-DD）
$range_start = date('Y-m-d', strtotime('-11 days'));
$range_end = date('Y-m-d', strtotime('-8 days'));
$date_range = "{$range_start}...{$range_end}";

// 构建订单查询参数
$order_query = new \WC_Order_Query([
    'status' => 'completed', // 仅筛选已完成订单
    'date_completed' => $date_range,
    'meta_query' => [
        'relation' => 'OR', // 两个条件满足其一即可
        [
            'key'     => 'x_days_follow_up_email',
            'value'   => 'yes',
            'compare' => '!='
        ],
        [
            'key'     => 'x_days_follow_up_email',
            'compare' => 'NOT EXISTS' // 字段不存在的情况
        ]
    ]
]);

// 获取符合条件的订单
$target_orders = $order_query->get_orders();

代码说明 #

• 明确指定status为completed，避免查询到其他状态的无效订单
• meta_query中用OR关联两个条件：字段值不等于yes，或者字段本身不存在
• 时间范围用...连接起始和结束日期，符合WC_Order_Query的date_completed参数格式要求

分析你之前方法失效的原因 #

1. 挂钩woocommerce_order_data_store_cpt_get_orders_query的问题 #

你把整个OR条件组作为单个元素加入$query['meta_query']，但如果WooCommerce本身已有其他元查询条件，默认的relation是AND，会导致你的OR组和其他条件强制关联，最终筛选出空结果。另外esc_attr()在这里是多余的，直接使用传入的参数即可。

2. 旧版本代码失效的原因 #

早期WooCommerce可能支持meta_key/meta_value/meta_compare作为WC_Order_Query的直接参数，但新版本已经废弃了这种用法，转而统一使用meta_query，所以更新后代码失效。

3. WP_Query性能问题 #

posts_per_page=-1会一次性加载所有符合条件的订单，当订单量庞大时，必然导致内存溢出或超时。WC_Order_Query默认会分页（默认每页10条），可以通过分页循环查询避免这个问题。

可选：修正挂钩方式的代码（如果坚持用钩子） #

如果你还是想通过钩子实现，需要确保元查询的关系逻辑正确：

add_filter('woocommerce_order_data_store_cpt_get_orders_query', 'filter_follow_up_orders', 10, 2);
function filter_follow_up_orders($query, $query_vars) {
    if (!empty($query_vars['x_days_follow_up_email'])) {
        // 初始化meta_query（如果不存在）
        if (!isset($query['meta_query'])) {
            $query['meta_query'] = [];
        }
        
        // 将OR条件组作为子查询加入meta_query
        $query['meta_query'][] = [
            'relation' => 'OR',
            [
                'key'     => 'x_days_follow_up_email',
                'value'   => $query_vars['x_days_follow_up_email'],
                'compare' => '!='
            ],
            [
                'key'     => 'x_days_follow_up_email',
                'compare' => 'NOT EXISTS'
            ]
        ];
    }
    return $query;
}

// 使用钩子的查询代码
$order_query = new \WC_Order_Query([
    'status' => 'completed',
    'date_completed' => $date_range,
    'x_days_follow_up_email' => 'yes'
]);
$target_orders = $order_query->get_orders();

性能优化建议 #

1. 给元字段加索引：针对x_days_follow_up_email字段添加数据库索引，大幅提升查询速度：

   CREATE INDEX idx_postmeta_follow_up_email ON wp_postmeta (meta_key, meta_value);
   

   注意替换wp_postmeta为你的实际数据库表前缀。

2. 分页查询：避免一次性加载所有订单，通过分页循环处理：

   $paged = 1;
   $per_page = 50; // 每页处理50条，可根据服务器配置调整
   
   while (true) {
       $order_query = new \WC_Order_Query([
           'status' => 'completed',
           'date_completed' => $date_range,
           'meta_query' => [/* 你的条件 */],
           'posts_per_page' => $per_page,
           'paged' => $paged
       ]);
       
       $orders = $order_query->get_orders();
       if (empty($orders)) break;
       
       // 在这里处理订单逻辑
       foreach ($orders as $order) {
           // 你的操作
       }
       
       $paged++;
   }
   

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