如何通过WooCommerce按订单项元键值获取完整订单对象？

我需要基于选定的产品变体属性获取特定订单的完整列表，对应的SQL查询如下：

SELECT * FROM wp_woocommerce_order_items LEFT JOIN wp_woocommerce_order_itemmeta 
ON wp_woocommerce_order_items.order_item_id = wp_woocommerce_order_itemmeta.order_item_id 
WHERE wp_woocommerce_order_itemmeta.meta_key = "size" AND wp_woocommerce_order_itemmeta.meta_value = "A2"

我希望用WooCommerce函数获取匹配该元数据的完整订单对象列表，根据文档写了以下PHP代码，但执行后返回空数组（var_dump($orders)显示array(0){}）：

/**
 * Handle a custom 'customvar' query var to get orders with the 'customvar' meta.
 * @param array $query - Args for WP_Query.
 * @param array $query_vars - Query vars from WC_Order_Query.
 * @return array modified $query
 */
function handle_custom_query_var( $query, $query_vars ) {
    if ( ! empty( $query_vars['size'] ) ) {
        $query['meta_query'][] = array(
            'key' => 'size',
            'value' => esc_attr( $query_vars['size'] ),
        );
    }

    return $query;
}
add_filter( 'woocommerce_order_data_store_cpt_get_orders_query', 'handle_custom_query_var', 10, 2 );

function woocommerce_orders_export()
{
    $orders = wc_get_orders(array('size' => 'A2'));
}

目前我用了临时解决方案，直接操作数据库：

function get_orders_by_meta_key_value( $meta_key, $meta_value ) {
    global $wpdb;

    // Get order item IDs based on meta_key and meta_value
    $order_item_ids = $wpdb->get_col( "
    SELECT order_item_id
    FROM {$wpdb->prefix}woocommerce_order_itemmeta
    WHERE meta_key = '{$meta_key}'
    AND meta_value = '{$meta_value}'
  " );

    // Get order IDs based on order_item_ids
    $order_ids = $wpdb->get_col( "
    SELECT DISTINCT order_id
    FROM {$wpdb->prefix}woocommerce_order_items
    WHERE order_item_id IN (" . implode( ',', $order_item_ids ) . ")
  " );

    // Get orders based on order_ids
    $orders = array();
    foreach ( $order_ids as $order_id ) {
        $orders[] = wc_get_order( $order_id );
    }

    return $orders;
}

请问如何正确使用WooCommerce函数实现该需求？

你的代码返回空数组的核心原因是：wc_get_orders的meta_query默认针对订单自身的元数据（存储在wp_postmeta），而你要筛选的是订单项的元数据（存储在wp_woocommerce_order_itemmeta），两者不属于同一数据集合，所以原查询无法匹配到结果。

要通过WooCommerce原生函数实现需求，需要在woocommerce_order_data_store_cpt_get_orders_query过滤器中，手动关联订单项和订单项元数据表，获取匹配的订单ID后，再传递给wc_get_orders。

以下是正确的实现代码：

/**
 * 处理自定义查询变量，筛选包含特定订单项元数据的订单
 * @param array $query WP_Query参数数组
 * @param array $query_vars WC_Order_Query的查询变量
 * @return array 修改后的查询参数
 */
function handle_order_item_meta_query_var( $query, $query_vars ) {
    if ( ! empty( $query_vars['size'] ) ) {
        global $wpdb;

        // 安全查询匹配size的订单ID，去重避免重复订单
        $matching_order_ids = $wpdb->get_col( $wpdb->prepare( "
            SELECT DISTINCT oi.order_id
            FROM {$wpdb->prefix}woocommerce_order_items oi
            INNER JOIN {$wpdb->prefix}woocommerce_order_itemmeta oim 
                ON oi.order_item_id = oim.order_item_id
            WHERE oim.meta_key = %s 
                AND oim.meta_value = %s
        ", 'size', sanitize_text_field( $query_vars['size'] ) ) );

        if ( $matching_order_ids ) {
            $query['post__in'] = $matching_order_ids;
        } else {
            // 无匹配时设置空数组的占位，确保返回空结果
            $query['post__in'] = [0];
        }
    }

    return $query;
}
add_filter( 'woocommerce_order_data_store_cpt_get_orders_query', 'handle_order_item_meta_query_var', 10, 2 );

// 使用示例
function woocommerce_orders_export() {
    $orders = wc_get_orders( ['size' => 'A2'] );
    // 处理获取到的订单对象
    var_dump( $orders );
}

关键说明 #

• 安全查询：用$wpdb->prepare和sanitize_text_field避免SQL注入风险，符合WordPress安全规范。
• 去重处理：用DISTINCT确保每个订单ID只返回一次，避免同一订单因多个订单项匹配而重复出现。
• 原生函数兼容：最终通过post__in参数将筛选结果传递给wc_get_orders，直接返回完整的订单对象，无需手动实例化，保留WooCommerce原生函数的优势。

这个方案比临时方案更高效，且完全基于WooCommerce的查询机制实现，维护性更好。

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